---
id: hatchet-sdk
version: "1.37.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# hatchet-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.

License: permissive · Maintenance: active · Downloads: 1.4M/mo

## What it is and what it does

Hatchet SDK is the official Python client for integrating Hatchet, a distributed fault-tolerant task queue, into your applications. It provides APIs for defining workflows with dependencies, parallel execution, automatic retry policies, and event-driven triggers. The SDK handles communication with a Hatchet server via gRPC and includes observability hooks (prometheus-client) for monitoring workflow execution.

You use it to register task handlers in your Python code, define workflow orchestration logic, and schedule or trigger those workflows from your application. It abstracts away the complexity of distributed task coordination—retries, fault tolerance, and scheduling are handled by the framework. The SDK requires Python 3.10+ and depends on aiohttp for async HTTP, pydantic for configuration, and gRPC for server communication.

Use it for:

- Build a multi-step data pipeline where tasks depend on prior results and failed steps automatically retry.
- Schedule recurring reports or batch jobs to run at specific times without managing cron jobs.
- Trigger long-running operations (file processing, API calls) from a web request without blocking the response.
- Coordinate parallel tasks across multiple workers and aggregate their results.
- Monitor and observe task execution metrics and workflow progress in real time.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Hatchet SDK is the official Python client for Hatchet, a distributed task queue that lets you define, schedule, and orchestrate workflows with automatic retries and event-driven triggers.

Yes, if you need distributed task orchestration in Python. The SDK is actively maintained (1 day old release), has low install friction, no known vulnerabilities, and a permissive MIT license. It's well-suited for workflows, scheduling, and event-driven task execution. Install it if you're already running a Hatchet server or planning to; otherwise, verify that Hatchet's architecture fits your deployment model.

## Install

pip install hatchet-sdk
uv add hatchet-sdk
poetry add hatchet-sdk

## Installing hatchet-sdk

Before you install: Low friction install with a pure-Python wheel. Active maintenance (released 2026-08-13, 1 day old). Depends on 12 runtime packages including aiohttp, grpcio, pydantic, and prometheus-client—a moderate but standard set for a distributed systems client.

License in practice: MIT license is permissive; you can use, modify, and distribute this SDK with minimal restrictions, including in commercial projects.

Quickstart:

pip install hatchet-sdk

from hatchet_sdk import Hatchet

hatchet = Hatchet()
# Define and run workflows via the SDK

Requires Python 3.10 or later (supports current versions, <4). A running Hatchet server instance is needed to execute workflows.

Verify before relying:

- Whether the SDK requires network connectivity to a Hatchet server at import time or only at workflow execution.
- Performance characteristics and throughput limits for typical workflow loads.
- Whether gRPC dependencies (grpcio, grpcio-tools) are optional or always required.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

distributed task queue python, workflow orchestration sdk, async job scheduling, fault-tolerant task runner, event-driven workflow engine, python task scheduling library, background job queue, task-queue, workflow-orchestration, async-jobs

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