Project Links

Meta

Author: Dapr Authors

Requires Python: >=3.10

Classifiers

Development Status

5 - Production/Stable

Intended Audience

Developers

License

OSI Approved :: Apache Software License

Operating System

OS Independent

Programming Language

Python
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14

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
dapr.ext.grpc: gRPC extension for Dapr
dapr.ext.fastapi: FastAPI extension (actor) for Dapr
flask.dapr: Flask extension (actor) for Dapr

Getting started

Prerequisites

Install Dapr python sdk

Official package

# Install Dapr client sdk
pip3 install dapr

# Install Dapr gRPC AppCallback service extension
pip3 install dapr-ext-grpc

# Install Dapr Fast Api extension for Actor
pip3 install dapr-ext-fastapi

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 service extension
pip3 install "dapr-ext-grpc @ git+https://github.com/dapr/python-sdk.git@main#subdirectory=ext/dapr-ext-grpc"

# Install the latest dev build of the FastAPI extension for Actor
pip3 install "dapr-ext-fastapi @ git+https://github.com/dapr/python-sdk.git@main#subdirectory=ext/dapr-ext-fastapi"

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

Install uv
Clone python-sdk

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

Install all packages and dev dependencies

uv sync --all-packages --group dev

Run linter and autofix

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

Run unit tests

uv run python -m unittest discover -v ./tests

Run type check

uv run mypy

Run integration tests

uv run pytest tests/integration/

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).