# Hanzo Tasks
Durable workflow execution engine for AI agent orchestration.
[](https://github.com/hanzoai/tasks/blob/main/LICENSE)
## Introduction
Hanzo Tasks is a durable execution engine that powers AI agent orchestration in the Hanzo ecosystem. It enables developers to build scalable, fault-tolerant workflows that automatically handle intermittent failures and retry failed operations.
Tasks provides the backbone for:
- **Playground spaces** -- each space maps to a Tasks namespace
- **Agent execution** -- each agent runs as a Tasks worker
- **Durable cron and batch jobs** -- reliable scheduled and bulk operations
MIT licensed. See [LICENSE](./LICENSE).
## Getting Started
### Build
```bash
make tasksd
```
### Run
```bash
./tasksd start
```
Or with a config file:
```bash
./tasksd --config-file config/development-sqlite.yaml --allow-no-auth start
```
### Build from source
```bash
go build ./cmd/tasksd/
./tasksd start
```
## Module
```
github.com/hanzoai/tasks
```
## Integration
Hanzo Tasks integrates with the broader Hanzo ecosystem:
- **Playground** connects to the Tasks server via the durable-execution SDK
- **Base** embeds Tasks for durable cron/batch execution
- Each playground **space** = a Tasks namespace
- Each **agent** = a Tasks worker
## Repository
This repository contains the source code of the Hanzo Tasks server.
The wire is **luxfi/zap** (binary, native, on `_tasks._tcp:9999`).
There is no gRPC and no go.temporal.io anywhere in the build.
To drive Tasks from Go, depend on [`pkg/sdk`](./pkg/sdk) — the native
ZAP client. To embed the server in a Go process (e.g. a Hanzo Base
app), depend on [`pkg/tasks`](./pkg/tasks) and call `tasks.Embed()`.
Browser clients hit the JSON shim at `/v1/tasks/*` and the realtime
stream at `/v1/tasks/events` (Server-Sent Events). AI agents hit the
MCP surface at `/v1/tasks/mcp` (JSON-RPC 2.0).
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
## License
[MIT License](https://github.com/hanzoai/tasks/blob/main/LICENSE)