---
id: durabletask
version: "1.9.0"
license: MIT License Copyright (c) Microsoft Corporation. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# durabletask — A Durable Task Client SDK for Python

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

## 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 above — 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

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

- License: MIT License Copyright (c) Microsoft Corporation. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 388.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

durable workflow orchestration, reliable task scheduling python, azure durable functions sdk, fault-tolerant workflow engine, distributed task orchestration, replay-based workflow framework, long-running process management, workflow-orchestration, azure-integration, fault-tolerance

[View on SkillFed](https://skillfed.io/packages/durabletask) · [View on PyPI](https://pypi.org/project/durabletask/)