This is the official Python SDK for Hatchet, a distributed, fault-tolerant task queue. The SDK allows you to easily integrate Hatchet's task scheduling and workflow orchestration capabilities into your Python applications.
Project Links
Meta
Author: Alexander Belanger, Matt Kaye, Gabe Ruttner, Mohammed Nafees
Requires Python: <4,>=3.10
Classifiers
Hatchet Python SDK
This is the official Python SDK for Hatchet, a distributed, fault-tolerant task queue. The SDK allows you to easily integrate Hatchet's task scheduling and workflow orchestration capabilities into your Python applications.
Documentation for agents
The linked pages serve plain markdown for tools and agents. Full docs index: https://docs.hatchet.run/llms.txt
Setup and local development:
- Quickstart: https://docs.hatchet.run/v1/quickstart.md
- Running Hatchet locally: https://docs.hatchet.run/v1/running-locally.md
- Embedded mode: https://docs.hatchet.run/v1/embedded.md
Core concepts:
- Tasks: https://docs.hatchet.run/v1/tasks.md
- Workers: https://docs.hatchet.run/v1/workers.md
- Running tasks: https://docs.hatchet.run/v1/running-your-task.md
- DAGs: https://docs.hatchet.run/v1/directed-acyclic-graphs.md
- Durable execution: https://docs.hatchet.run/v1/durable-execution.md
Flow control:
- Concurrency: https://docs.hatchet.run/v1/concurrency.md
- Rate limits: https://docs.hatchet.run/v1/rate-limits.md
- Retries: https://docs.hatchet.run/v1/retry-policies.md
- Idempotency: https://docs.hatchet.run/v1/idempotency.md
- CEL expressions: https://docs.hatchet.run/v1/cel-expressions.md
Python SDK reference (overview: https://docs.hatchet.run/reference/python.md):
- CEL: https://docs.hatchet.run/reference/python/feature-clients/cel.md (guide: https://docs.hatchet.run/v1/cel-expressions.md)
- Crons: https://docs.hatchet.run/reference/python/feature-clients/cron.md (guide: https://docs.hatchet.run/v1/cron-runs.md)
- Filters: https://docs.hatchet.run/reference/python/feature-clients/filters.md (guide: https://docs.hatchet.run/v1/events.md)
- Logs: https://docs.hatchet.run/reference/python/feature-clients/logs.md (guide: https://docs.hatchet.run/v1/logging.md)
- Metrics: https://docs.hatchet.run/reference/python/feature-clients/metrics.md (guide: https://docs.hatchet.run/v1/prometheus-metrics.md)
- Rate Limits: https://docs.hatchet.run/reference/python/feature-clients/rate_limits.md (guide: https://docs.hatchet.run/v1/rate-limits.md)
- Runs: https://docs.hatchet.run/reference/python/feature-clients/runs.md (guide: https://docs.hatchet.run/v1/running-your-task.md)
- Scheduled Runs: https://docs.hatchet.run/reference/python/feature-clients/scheduled.md (guide: https://docs.hatchet.run/v1/scheduled-runs.md)
- Stubs: https://docs.hatchet.run/reference/python/feature-clients/stubs.md (guide: https://docs.hatchet.run/v1/inter-service-triggering.md)
- Webhooks: https://docs.hatchet.run/reference/python/feature-clients/webhooks.md (guide: https://docs.hatchet.run/v1/webhooks.md)
- Workers: https://docs.hatchet.run/reference/python/feature-clients/workers.md (guide: https://docs.hatchet.run/v1/workers.md)
- Workflows: https://docs.hatchet.run/reference/python/feature-clients/workflows.md (guide: https://docs.hatchet.run/v1/tasks.md)
Installation
Install the SDK using pip:
pip install hatchet-sdk
Or using poetry:
poetry add hatchet-sdk
Quick Start
For examples of how to use the Hatchet Python SDK, including worker setup and task execution, please see our official documentation.
Features
- ๐ Workflow Orchestration: Define complex workflows with dependencies and parallel execution
- ๐ Automatic Retries: Configure retry policies for handling transient failures
- ๐ Observability: Track workflow progress and monitor execution metrics
- โฐ Scheduling: Schedule workflows to run at specific times or on a recurring basis
- ๐ Event-Driven: Trigger workflows based on events in your system
Documentation
For detailed documentation, examples, and best practices, visit:
Contributing
We welcome contributions! Please check out our contributing guidelines and join our Discord community for discussions and support.
License
This SDK is released under the MIT License. See LICENSE for details.
1.41.1
Sep 24, 2026
1.41.0
Sep 22, 2026
1.40.3
Sep 18, 2026
1.40.1
Sep 09, 2026
1.40.0
Sep 04, 2026
1.39.0
Aug 31, 2026
1.38.2
Aug 31, 2026
1.38.1
Aug 25, 2026
1.38.0
Aug 24, 2026
1.37.5
Aug 22, 2026
1.37.4
Aug 20, 2026
1.37.3
Aug 19, 2026
1.37.2
Aug 13, 2026
1.37.1
Aug 03, 2026
1.37.0
Jul 30, 2026
1.35.1
Jul 20, 2026
1.35.0
Jul 16, 2026
1.34.1
Jul 16, 2026
1.34.0
Jul 16, 2026
1.33.18
Jul 09, 2026
1.33.17
Jul 07, 2026
1.33.16
Jul 06, 2026
1.33.15
Jul 02, 2026
1.33.14
Jun 30, 2026
1.33.13
Jun 26, 2026
1.33.12
Jun 20, 2026
1.33.11
Jun 18, 2026
1.33.10
Jun 17, 2026
1.33.9
Jun 15, 2026
1.33.7
Jun 09, 2026
1.33.6
May 28, 2026
1.33.5
May 12, 2026
1.33.4
May 12, 2026
1.33.3
Apr 30, 2026
1.33.2
Apr 22, 2026
1.33.1
Apr 21, 2026
1.33.0
Apr 21, 2026
1.32.3
Apr 16, 2026
1.32.2
Apr 16, 2026
1.32.1
Apr 09, 2026
1.32.0
Apr 07, 2026
1.31.0
Apr 03, 2026
1.30.0
Apr 03, 2026
1.29.5
Apr 02, 2026
1.29.4
Apr 01, 2026
1.29.3
Mar 24, 2026
1.29.2
Mar 17, 2026
1.29.0
Mar 16, 2026
1.28.2
Mar 14, 2026
1.28.1
Mar 06, 2026
1.28.0
Mar 04, 2026
1.27.2
Feb 28, 2026
1.27.1
Feb 28, 2026
1.27.0
Feb 27, 2026
1.26.2
Feb 26, 2026
1.26.1
Feb 26, 2026
1.26.0
Feb 25, 2026
1.25.2
Feb 19, 2026
1.25.0
Feb 17, 2026
1.24.0
Feb 13, 2026
1.23.4
Feb 13, 2026
1.23.3
Feb 12, 2026
1.23.2
Feb 12, 2026
1.23.1
Feb 11, 2026
1.23.0
Feb 05, 2026
1.22.16
Feb 05, 2026
1.22.15
Feb 03, 2026
1.22.14
Feb 01, 2026
1.22.13
Jan 30, 2026
1.22.12
Jan 29, 2026
1.22.11
Jan 27, 2026
1.22.10
Jan 26, 2026
1.22.9
Jan 26, 2026
1.22.8
Jan 21, 2026
1.22.7
Jan 19, 2026
1.22.6
Jan 14, 2026
1.22.5
Jan 12, 2026
1.22.4
Jan 08, 2026
1.22.3
Jan 07, 2026
1.22.2
Dec 31, 2025
1.22.1
Dec 31, 2025
1.22.0
Dec 26, 2025
1.21.7
Dec 17, 2025
1.21.6
Dec 11, 2025
1.21.5
Dec 08, 2025
1.21.4
Dec 04, 2025
1.21.3
Nov 26, 2025
1.21.2
Nov 14, 2025
1.21.1
Nov 08, 2025
1.21.0
Oct 31, 2025
1.20.2
Oct 23, 2025
1.20.1
Oct 15, 2025
1.20.0
Oct 03, 2025
1.19.0
Sep 24, 2025
1.18.1
Aug 26, 2025
1.18.0
Aug 26, 2025
1.17.2
Aug 20, 2025
1.17.1
Aug 18, 2025
1.17.0
Aug 12, 2025
1.16.5
Aug 06, 2025
1.16.4
Jul 30, 2025
1.16.3
Jul 23, 2025
1.16.2
Jul 22, 2025
1.16.1
Jul 21, 2025
1.16.0
Jul 17, 2025
1.15.3
Jul 14, 2025
1.15.2
Jul 12, 2025
1.15.1
Jul 11, 2025
1.15.0
Jul 10, 2025
1.14.4
Jul 09, 2025
1.14.3
Jul 09, 2025
1.14.2
Jul 03, 2025
1.14.1
Jul 03, 2025
1.14.0
Jun 26, 2025
1.13.0
Jun 25, 2025
1.12.3
Jun 25, 2025
1.12.2
Jun 17, 2025
1.12.1
Jun 13, 2025
1.12.0
Jun 10, 2025
1.11.1
Jun 05, 2025
1.11.0
May 30, 2025
1.10.3
May 27, 2025
1.10.2
May 19, 2025
1.10.1
May 16, 2025
1.10.0
May 16, 2025
1.9.1
May 16, 2025
1.9.0
May 14, 2025
1.8.2
May 13, 2025
1.8.1
May 07, 2025
1.8.0
May 06, 2025
1.7.0
Apr 30, 2025
1.6.5
Apr 26, 2025
1.6.4
Apr 26, 2025
1.6.3
Apr 18, 2025
1.6.2
Apr 18, 2025
1.6.1
Apr 15, 2025
1.6.0
Apr 15, 2025
1.5.0
Apr 14, 2025
1.4.1
Apr 14, 2025
1.4.0
Apr 14, 2025
1.3.2
Apr 10, 2025
1.3.1
Apr 10, 2025
1.3.0
Apr 10, 2025
1.2.6
Apr 10, 2025
1.2.5
Apr 08, 2025
1.2.4
Apr 07, 2025
1.2.3
Apr 03, 2025
1.2.2
Apr 03, 2025
1.2.1
Apr 02, 2025
1.2.0
Apr 01, 2025
1.1.0
Mar 31, 2025
1.0.3
Mar 31, 2025
1.0.2
Mar 29, 2025
1.0.1
Mar 27, 2025
1.0.0
Mar 11, 2025
1.0.0a1
Mar 25, 2025
0.47.1
Mar 21, 2025
0.47.0
Feb 19, 2025
0.46.1
Feb 12, 2025
0.46.0
Feb 11, 2025
0.45.3
Feb 05, 2025
0.45.3b1
Feb 03, 2025
0.45.2
Jan 31, 2025
0.45.1
Jan 29, 2025
0.45.0
Jan 28, 2025
0.44.2
Jan 22, 2025
0.44.1
Jan 19, 2025
0.44.0
Jan 18, 2025
0.43.3
Jan 16, 2025
0.43.2
Jan 05, 2025
0.43.1
Dec 31, 2024
0.43.0
Dec 30, 2024
0.42.5
Dec 20, 2024
0.42.4
Dec 19, 2024
0.42.3
Dec 17, 2024
0.42.2
Dec 16, 2024
0.42.1
Dec 06, 2024
0.42.0
Dec 06, 2024
0.41.0
Dec 03, 2024
0.40.0a9
Oct 29, 2024
0.40.0a8
Oct 28, 2024
0.40.0a7
Oct 28, 2024
0.40.0a6
Oct 28, 2024
0.40.0a5
Oct 28, 2024
0.40.0a4
Oct 28, 2024
0.40.0a3
Oct 28, 2024
0.40.0a2
Oct 28, 2024
0.40.0a1
Oct 28, 2024
0.39.0a1
Oct 24, 2024
0.39.0a0
Oct 23, 2024
0.38.3
Oct 14, 2024
0.38.2
Oct 10, 2024
0.38.1
Oct 01, 2024
0.38.0
Sep 27, 2024
0.37.2
Sep 25, 2024
0.37.1
Sep 23, 2024
0.37.0
Sep 19, 2024
0.36.24
Sep 19, 2024
0.36.23
Sep 19, 2024
0.36.23a0
Sep 13, 2024
0.36.22
Sep 13, 2024
0.36.21
Sep 11, 2024
0.36.20
Sep 11, 2024
0.36.19
Sep 10, 2024
0.36.18
Sep 10, 2024
0.36.17
Sep 05, 2024
0.36.16
Sep 05, 2024
0.36.13
Aug 28, 2024
0.36.12
Aug 28, 2024
0.36.11
Aug 28, 2024
0.36.10
Aug 27, 2024
0.36.9
Aug 27, 2024
0.36.8
Aug 26, 2024
0.36.7
Aug 24, 2024
0.36.6
Aug 23, 2024
0.36.5
Aug 23, 2024
0.36.3
Aug 23, 2024
0.36.2
Aug 23, 2024
0.36.1
Aug 22, 2024
0.36.0
Aug 22, 2024
0.35.1
Aug 20, 2024
0.35.0
Aug 20, 2024
0.34.0a6
Aug 13, 2024
0.34.0a5
Aug 01, 2024
0.34.0a4
Jul 30, 2024
0.34.0a2
Jul 30, 2024
0.34.0a1
Jul 29, 2024
0.32.0
Jul 29, 2024
0.31.6a2
Jul 25, 2024
0.31.6a1
Jul 24, 2024
0.31.5
Jul 23, 2024
0.31.4
Jul 22, 2024
0.31.3
Jul 22, 2024
0.31.2
Jul 20, 2024
0.31.1
Jul 19, 2024
0.31.0
Jul 17, 2024
0.30.0
Jul 15, 2024
0.29.1
Jul 15, 2024
0.29.0
Jul 11, 2024
0.28.2
Jul 08, 2024
0.28.1
Jul 08, 2024
0.28.0
Jul 08, 2024
0.27.5
Jul 04, 2024
0.27.4
Jul 04, 2024
0.27.3
Jul 04, 2024
0.27.2
Jul 04, 2024
0.27.1
Jun 20, 2024
0.27.0
Jun 18, 2024
0.26.4b2
Jun 12, 2024
0.26.4b1
Jun 12, 2024
0.26.4b0
Jun 12, 2024
0.26.3
Jun 09, 2024
0.26.2
Jun 06, 2024
0.26.1
Jun 03, 2024
0.26.0
Jun 01, 2024
0.25.4
Jun 01, 2024
0.25.3
May 31, 2024
0.25.2
May 31, 2024
0.25.1
May 31, 2024
0.25.0
May 30, 2024
0.25.0b1
May 27, 2024
0.24.0
May 16, 2024
0.23.2
May 15, 2024
0.23.1
May 10, 2024
0.23.0
May 08, 2024
0.22.5
Apr 24, 2024
0.22.4
Apr 24, 2024
0.22.3
Apr 22, 2024
0.22.2
Apr 22, 2024
0.22.1
Apr 22, 2024
0.22.0
Apr 15, 2024
0.21.1
Apr 04, 2024
0.21.0
Apr 02, 2024
0.20.0
Apr 01, 2024
0.18.0
Mar 23, 2024
0.16.0
Mar 11, 2024
0.15.4
Mar 08, 2024
0.15.3
Mar 07, 2024
0.15.2
Mar 07, 2024
0.15.1
Mar 06, 2024
0.15.0
Mar 03, 2024
0.12.0
Feb 26, 2024
0.10.5
Feb 22, 2024
0.10.4
Feb 22, 2024
0.10.3
Feb 20, 2024
0.10.2
Feb 20, 2024
0.10.1
Feb 19, 2024
0.10.0
Feb 19, 2024
0.9.4
Feb 09, 2024
0.9.3
Feb 06, 2024
0.9.2
Feb 05, 2024
0.9.1
Feb 05, 2024
0.9.0
Feb 05, 2024
0.8.0
Feb 03, 2024
0.7.1
Jan 30, 2024
0.7.0
Jan 29, 2024
0.6.0
Jan 28, 2024
0.5.0
Jan 23, 2024
0.4.0
Jan 23, 2024
0.3.0
Jan 23, 2024
0.2.0
Jan 19, 2024
Wheel compatibility matrix
Files in release
Extras:
Dependencies:
aiohttp
(<4,>=3.10.5)
grpcio-status
(<2,>=1.76.0)
grpcio-tools
(<2,>=1.76.0)
grpcio
(<2,>=1.76.0)
prometheus-client
(>=0.21.1)
protobuf
(<7,>=6.30.2)
pydantic-settings
(<3,>=2.7.1)
pydantic
(<3,>=2.6.3)
python-dateutil
(<3,>=2.9.0.post0)
tenacity
(>=8.4.1)
typing-inspection
(>=0.1.0)
urllib3
(<3,>=2.6.0)