Skip to main content

Python Workflow SDK

Build stateful, long-running, reliable workflows using the Dapr Workflow Python SDK with Diagrid. The Dapr Workflow Python SDK provides a powerful way to orchestrate complex business processes using Python.

Prefer to start from a diagram? Use Dapr Skills for Claude Code to generate a runnable Python Dapr Workflow project from a workflow diagram, then iterate with this SDK. For local monitoring of running workflows, use the Dapr Dev Dashboard.

Start hereโ€‹

Resourcesโ€‹

Prerequisites:

Installationโ€‹

Install the Dapr Python SDK with the workflow extra:

pip3 install "dapr[workflow]"
note

Do not install the separate dapr-ext-workflow package. The Dapr Python SDK now ships the workflow code as the workflow extra of the dapr package, and pip install dapr-ext-workflow installs version 1.18.3 of the old package.

Core Applicationโ€‹

Use the essential components of a Dapr Workflow application (Workflows and Activities) to build and run a workflow application.

External Eventsโ€‹

Wait for external input and send events to running workflows.

Observabilityโ€‹

Configure and use observability features to monitor and debug workflows.

Getting Startedโ€‹