temporalio

Temporal.io Python SDK

temporalio Permissive license MIT Active ★ 1,162 v1.31.0 released 2026-07-29

Install

temporalio on PyPI

pip

pip install temporalio

uv

uv add temporalio

poetry

poetry add temporalio

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	medium — platform-specific wheel
Runtime dependencies	5 — nexus-rpc, protobuf, python-dateutil, types-protobuf, typing-extensions
Maintenance	actively maintained — 15 days since the last release
Last repo commit	2026-08-13
First released	2022-03-18
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: temporalio-1.31.0-cp310-abi3-macosx_10_12_x86_64.whl; temporalio-1.31.0-cp310-abi3-macosx_11_0_arm64.whl; temporalio-1.31.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; temporalio-1.31.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; temporalio-1.31.0-cp310-abi3-musllinux_1_2_aarch64.whl; temporalio-1.31.0-cp310-abi3-musllinux_1_2_x86_64.whl; temporalio-1.31.0-cp310-abi3-win_amd64.whl

Keywords: temporal, workflow

License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14

About temporalio

from the package's own PyPI description — quoted content, verbatim

Temporal Python SDK (image)

Python 3.9+ (image) PyPI (image) MIT (image)

📣 News: Integration between OpenAI Agents SDK and Temporal is now in public preview. Learn more.

Temporal is a distributed, scalable, durable, and highly available orchestration engine used to execute asynchronous, long-running business logic in a scalable and resilient way.

"Temporal Python SDK" is the framework for authoring workflows and activities using the Python programming language.

Also see: * Application Development Guide - Once you've tried our Quick Start, check out our guide on how to use Temporal in your Python applications, including information around Temporal core concepts. * [Python Code...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Temporal Python SDK provides a framework for building distributed, durable workflows and activities that execute long-running business logic reliably across failures using an asyncio-based event loop.

Medium install friction due to compiled wheels (cp310-abi3 binaries for multiple platforms); active maintenance with a release 15 days ago and 1162 repository stars suggests solid ongoing support.

MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal obligations.

Usage

pip install temporalio

from temporalio import activity, workflow
from temporalio.client import Client

@activity.defn
def say_hello(name: str) -> str:
    return f"Hello, {name}!"

@workflow.defn
class GreetingWorkflow:
    @workflow.run
    async def run(self, name: str) -> str:
        return await workflow.execute_activity(say_hello, name)

Requires Python 3.10 or later; Temporal Server must be running to execute workflows.

Verdict: Actively maintained orchestration framework with permissive MIT licensing, suitable for production use. Medium install friction from compiled dependencies is typical for performance-critical SDKs. No known security vulnerabilities. Best suited for teams building distributed, long-running workflows that need durability and fault tolerance.

Needs verification

Whether Temporal Server setup and operational complexity is a practical blocker for small teams or prototypes
Performance characteristics and resource overhead compared to alternative workflow engines
Real-world adoption rate and ecosystem maturity beyond the top-1000 popularity tier

distributed workflow orchestrationdurable task execution frameworkasync workflow enginelong-running job schedulerfault-tolerant activity runnertemporal workflow sdkasyncio-based orchestration