durabletask

What it is and what it does

Durabletask is Microsoft's Python SDK for building durable orchestrations—long-running workflows that can pause, resume, and survive failures by replaying their execution history. It provides decorators and APIs to define orchestrator functions (which coordinate work) and activity functions (which perform individual tasks), allowing you to build reliable, fault-tolerant distributed systems without manually managing state or recovery logic.

The package integrates with Azure Durable Task Scheduler and Azure Durable Functions, handling the complexity of persisting execution state, retrying failed activities, and replaying orchestrations from checkpoints. It depends on grpcio and protobuf for communication, and packaging for version handling. Optional features like large payload externalization to Azure Blob Storage are available through extras.

Use it for:

• Build multi-step approval workflows that survive service restarts and network failures
• Orchestrate long-running business processes (e.g., order processing, document workflows) with automatic retry and state recovery
• Coordinate parallel and sequential tasks across distributed systems with built-in fault tolerance
• Implement fan-out/fan-in patterns where one orchestration spawns many activities and waits for results
• Create audit trails and replay-based debugging for complex asynchronous workflows

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Durabletask is a Python SDK for building durable orchestrations and workflows that can survive failures and be replayed reliably, designed to work with Azure Durable Task Scheduler and Azure Durable Functions.

Yes, if you are building on Azure infrastructure or need durable, replay-based orchestration. The package is production-stable, actively maintained, has no known vulnerabilities, and low install friction. It is worth installing for reliable long-running workflows; if you are not using Azure or do not need replay-based fault tolerance, simpler alternatives may suffice.

Install

durabletask on PyPI

pip install durabletask

uv add durabletask

poetry add durabletask

Installing durabletask

Before you install

Low friction installation with a pure Python wheel. The package is actively maintained with a recent release and no known vulnerabilities. Runtime dependencies on grpcio, protobuf, and packaging are standard and widely available.

License in practice

MIT License permits unrestricted use, modification, and distribution in both open-source and commercial projects, with only the requirement to include the license notice.

Quickstart

pip install durabletask

from durabletask import orchestrator, activity

@orchestrator
def my_orchestration(context):
    result = yield context.call_activity(my_activity, input_data)
    return result

@activity
def my_activity(input_data):
    return process(input_data)

Requires Python 3.10 or later. Orchestrations typically require a running Azure Durable Task Scheduler or Azure Durable Functions backend to execute.

Verify before relying

• Whether the package supports local development/testing without Azure infrastructure
• Performance characteristics and scalability limits for large orchestrations
• Exact replay semantics and determinism guarantees for complex workflows

Package facts

Evidence: durabletask-1.9.0-py3-none-any.whl

Keywords: durable, task, workflow

Tags

More Distributed Computing packages