Temporal Python SDK (temporalio)

Build durable, fault-tolerant distributed applications in Python. Temporal guarantees workflow completion even through process crashes, network failures, and server outages.

Installation

pip install temporalio

Requires Python >= 3.9. The SDK is a single package with no heavy dependencies.

Core Concepts

• Workflow: A durable function (defined as a class) that orchestrates activities and other workflows. Must be deterministic -- no random, no real I/O, no system time.
• Activity: A normal function (sync or async) that performs side effects -- API calls, database queries, file I/O.
• Worker: A process that polls a task queue and executes workflows and activities.
• Client: Connects to the Temporal server to start, signal, query, and cancel workflows.
• Task Queue: A named queue that routes work to workers. Workflows and activities are assigned to task queues.