Hatchet Orchestration Engine

Hatchet is an orchestration engine designed for building and deploying mission-critical AI agents, durable workflows, and background tasks. It provides a platform for queuing, automatic retries, real-time monitoring, alerting, and logging.

Key characteristics include:

• Durability: Every task and agent invocation is durably persisted, enabling debugging, retries, and replays.
• Language Support: Supports applications written in Python, TypeScript, Go, and Ruby.
• Deployment Options: Can be used as a managed service via Hatchet Cloud or self-hosted (100% MIT-licensed).
• Scalability: Designed for massive parallelization (millions of tasks) with worker-level slot control, fairness, and priority features.

The @hatchet-dev/typescript-sdk is designed for distributed, fault-tolerant task queuing and workflow orchestration. Key features include:

• Type Safety: Full TypeScript support with type inference for workflow inputs and outputs.
• 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.

The Hatchet Python SDK provides several core capabilities for managing distributed, fault-tolerant tasks:

• 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.

The Hatchet CLI is used for managing workflows, workers, and runs. Depending on your task, refer to the following operational areas:

• Setup: Setting up the CLI or creating a profile.
• Workers: Starting a worker.
• Workflows: Triggering a workflow and waiting for results.
• Debugging: Debugging a failed or stuck run.
• Replays: Replaying a run with the same or new input.

The Hatchet Dashboard provides a visual interface to monitor your orchestration engine. Use it to:

• Monitor Runs: Check the status, inputs, outputs, and execution history of specific workflow runs.
• Manage Workers: View connected workers and monitor their health status.
• Inspect Workflows: Review workflow definitions and recent activity.
• Configure Settings: Manage tenants, API tokens, and general configuration.

The Hatchet CLI provides several key utilities for development and observability:

• Quickstarts: Use hatchet quickstart to generate a worker project from a template.
• Local worker reloading: Use hatchet worker dev to run a worker locally with automatic reloading when code changes are detected.
• Terminal User Interface (TUI): Use hatchet tui to interact with your Hatchet deployment via a TUI for real-time observability into tasks, workflows, and workers.
• Profiles: Use hatchet profile commands to manage multiple Hatchet instances and tenants using named profiles, allowing easy switching between environments.

Hatchet Cloud is a managed service with the following security features:

• Encryption in transit: All API and worker traffic is encrypted with TLS. gRPC connections between workers and the engine use TLS by default.
• Encryption at rest: All data stored in Hatchet Cloud is encrypted at rest.
• Tenant isolation: Data is logically isolated per tenant. Requests are authenticated and scoped to a single tenant.
• Authentication: API tokens are scoped per-tenant with configurable expiration. The dashboard supports SSO (Google, GitHub, etc.).
• Infrastructure: Runs on AWS with private networking, automated patching, and centralized logging.

For compliance reports (SOC 2 Type II, HIPAA, GDPR) and definitive controls, visit the Hatchet Trust Center.

The Webhooks client allows you to manage incoming webhooks in Hatchet. Webhooks enable external systems (like GitHub, Stripe, or Slack) to trigger Hatchet workflows by sending HTTP requests to dedicated endpoints.

The client provides both synchronous and asynchronous (aio_) methods for managing webhooks. It is based on BaseRestClient.