Dapr SDK for Python

Dapr is a portable, event-driven, serverless runtime for building distributed applications across cloud and edge.

Dapr SDK for Python allows you to implement the Virtual Actor model, based on the actor design pattern. This SDK can run locally, in a container and in any distributed systems environment.

This includes the following packages:

• dapr.actor: Actor Framework
• dapr.clients: Dapr clients for Dapr building blocks
• dapr.conf: Configuration
• dapr.serializers: serializer/deserializer
• dapr.proto: Dapr gRPC autogenerated gRPC clients

And the following extensions, installed as extras on the core dapr package:

• dapr.ext.fastapi: FastAPI integration (actors, pub/sub) — pip install "dapr[fastapi]"
• dapr.ext.flask: Flask integration (actors, pub/sub) — pip install "dapr[flask]"
• dapr.ext.grpc: gRPC AppCallback server — pip install "dapr[grpc]"
• dapr.ext.langgraph: LangGraph checkpoint persistence — pip install "dapr[langgraph]"
• dapr.ext.strands: Strands agent session management — pip install "dapr[strands]"
• dapr.ext.workflow: Durable workflow authoring — pip install "dapr[workflow]"

Getting started

Prerequisites

• Install Dapr standalone mode
• Install Python 3.10+

Install Dapr python sdk

• Official package

# Install the Dapr client SDK
pip3 install dapr

# Install one or more extensions as extras
pip3 install "dapr[fastapi]"
pip3 install "dapr[grpc,workflow]"

# Or install everything
pip3 install "dapr[all]"

Migration from legacy distributions. The previously-separate packages (dapr-ext-fastapi, dapr-ext-grpc, dapr-ext-langgraph, dapr-ext-strands, dapr-ext-workflow, flask-dapr) are now extras on the core dapr package and are no longer published standalone. Import paths under dapr.ext.* are unchanged.

Existing installs must run all three steps below in order so pip rewrites the bundled files the legacy uninstall removes, without churning pinned transitive deps (fastapi, uvicorn, langchain, etc.):

pip uninstall -y dapr-ext-fastapi dapr-ext-grpc dapr-ext-langgraph dapr-ext-strands dapr-ext-workflow flask-dapr
pip install --force-reinstall --no-deps dapr
pip install "dapr[fastapi,workflow]"

import dapr emits a FutureWarning with the recovery command if the migration is skipped. Suppress with DAPR_SKIP_LEGACY_CHECK=1. The legacy flask_dapr top-level import remains as a thin shim that also emits a FutureWarning; the canonical path is dapr.ext.flask.

• In-development version

Only tagged releases are published to PyPI. To install the in-development version (the current state of main), point pip at the GitHub repository:

# Install the latest dev build of the Dapr client sdk
pip3 install "dapr @ git+https://github.com/dapr/python-sdk.git@main"

# Install the latest dev build of the gRPC AppCallback and FastAPI for Actor extensions
pip3 install "dapr[grpc,fastapi] @ git+https://github.com/dapr/python-sdk.git@main"

Replace @main with a commit SHA or release branch (e.g. @release-1.18) to pin to a specific point in history.

Try out examples

Go to Examples

Developing

Build and test

1. Install uv

2. Clone python-sdk

git clone https://github.com/dapr/python-sdk.git
cd python-sdk

3. Install all packages and dev dependencies

uv sync --all-packages --group dev

4. Run linter and autofix

uv run ruff check --fix && uv run ruff format

5. Run unit tests

# pytest is required: `unittest discover` silently skips the pytest-style
# tests under tests/ext/flask and tests/ext/workflow/durabletask.
uv run pytest -m "not e2e" ./tests --ignore=tests/integration --ignore=tests/examples

6. Run type check

uv run mypy

7. Run integration tests

uv run pytest tests/integration/

8. Validate the examples

uv run pytest tests/examples/

If you need to run the examples or integration tests against a pre-released version of the runtime, you can use the following command:

• Get your daprd runtime binary from here for your platform.
• Copy the binary to your dapr home folder at $HOME/.dapr/bin/daprd. Or using dapr cli directly: dapr init --runtime-version <release version>
• Now you can run the examples with uv run pytest tests/examples/ or the integration tests with uv run pytest tests/integration/.

Documentation

Documentation is generated using Sphinx. Extensions used are mainly Napoleon (To process the Google Comment Style) and Autodocs (For automatically generating documentation). The .rst files are generated using Sphinx-Apidocs.

To generate documentation:

uv run --with sphinx sphinx-apidoc -E -o docs/actor dapr/actor
uv run --with sphinx sphinx-apidoc -E -o docs/clients dapr/clients
uv run --with sphinx sphinx-apidoc -E -o docs/proto dapr/proto
uv run --with sphinx sphinx-apidoc -E -o docs/serializers dapr/serializers
uv run --with sphinx make html -C docs

The generated files will be found in docs/_build.

Generate gRPC Protobuf client

uv sync --all-packages --group dev
export DAPR_BRANCH=release-1.18 # Optional, defaults to master
uv run ./tools/regen_grpcclient.sh

Help & Feedback

Need help or have feedback on the SDK? Please open a GitHub issue or come chat with us in the #python-sdk channel of our Discord server (click here to join).

Code of Conduct

This project follows the CNCF Code of Conduct.