---
id: dapr-ext-workflow
version: "1.18.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# dapr-ext-workflow — Dapr Workflow Authoring Extension for the Dapr Python SDK.

License: permissive · Maintenance: active · Downloads: 184.4K/mo

## What it is and what it does

dapr-ext-workflow is an extension package for the Dapr Python SDK that adds workflow authoring and orchestration capabilities. It allows you to define, manage, and execute distributed workflows using Dapr's runtime, integrating with the broader Dapr ecosystem for service invocation, state management, and pub/sub messaging.

The package requires Python 3.10 or later and depends only on the dapr runtime package. It is actively maintained, with production-stable status and support for current Python versions through 3.14. The extension is positioned as part of Dapr's distributed application runtime, which handles workflow orchestration, scheduling, and execution across multiple services.

Use it for:

- Define multi-step business processes that span multiple microservices using Dapr's workflow primitives
- Orchestrate long-running operations with built-in retry, timeout, and state management via Dapr
- Build event-driven workflows that coordinate service calls and handle failures automatically
- Implement saga patterns for distributed transactions across services in a Dapr-enabled environment

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Extends the Dapr Python SDK with workflow authoring capabilities, enabling you to define and execute distributed workflows using Dapr's orchestration runtime.

Yes, if you are building microservices with Dapr and need workflow orchestration in Python. The package is production-stable, actively maintained, has no known vulnerabilities, and carries a permissive license. Install friction is minimal. Only consider skipping if you do not use Dapr or have no workflow orchestration requirements.

## Install

pip install dapr-ext-workflow
uv add dapr-ext-workflow
poetry add dapr-ext-workflow

## Installing dapr-ext-workflow

Before you install: Low friction install with a single runtime dependency on dapr. Active maintenance with a recent release (30 days ago) and sustained development activity.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.

Quickstart:

pip install dapr-ext-workflow

from dapr.ext.workflow import WorkflowRuntime

runtime = WorkflowRuntime()
runtime.register_workflow(my_workflow)
runtime.start()

Requires Dapr runtime to be installed and running; Python 3.10 or later is required.

Verify before relying:

- Whether this extension is required or optional for Dapr workflow use in the Python SDK
- Specific workflow patterns or use cases this extension enables beyond base Dapr
- Performance characteristics or scalability limits for workflows defined with this extension

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 184.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dapr workflow authoring, distributed workflow orchestration python, dapr python sdk extension, workflow engine dapr, python workflow automation, dapr-extension, workflow-orchestration, microservices

[View on SkillFed](https://skillfed.io/packages/dapr-ext-workflow) · [View on PyPI](https://pypi.org/project/dapr-ext-workflow/)