hatchet/sdks/python

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.

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Quick Start

Here's a simple example of how to use the Hatchet Python SDK:

from hatchet_sdk import Context, EmptyModel, Hatchet

hatchet = Hatchet(debug=True)


@hatchet.task(name="SimpleWorkflow")
def step1(input: EmptyModel, ctx: Context) -> None:
    print("executed step1")


def main() -> None:
    worker = hatchet.worker("test-worker", slots=1, workflows=[step1])
    worker.start()

if __name__ == "__main__":
    main()

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:

• Hatchet Documentation
• Examples

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.