Agent 跑长任务,最怕的不是模型笨,是半路断电。进程被 OOM 杀掉、机器重启、上游 API 超时,传统做法是把整条流程从头再跑一遍——前面调过的 LLM 再付一次钱,发过的邮件再发一封。Hatchet 就是冲着这件事来的:把每一步的状态写进 Postgres,崩了从检查点接着跑。
它是什么
hatchet-dev/hatchet,2023 年 12 月建仓,Go 写的引擎,MIT 许可。我查了下,到 11 月 9 日 8,256 星、535 个 fork,仓库当天还有提交。官方定位一句话:给后台任务、AI Agent 和耐久工作流做编排的引擎。
SDK 有四个语言:Python(1.45.1,11 月 5 日)、TypeScript、Go、Ruby(0.12.1)。引擎本体最新版 v0.114.2,10 月 26 日发布。同一套代码,云上跑和自托管跑没有区别。
它和 Restate 那种「单二进制、不要数据库」的路子正好相反:Hatchet 把全部赌注押在 Postgres 上,任务状态、事件日志、面板上的可观测数据,全在一个库里。
三个部件,一个库
结构不复杂:API server 负责 HTTP 接口和后台面板,Engine 负责调度、派活、记状态,Workers 跑你自己的代码——worker 永远在你自己的机器上。三者靠 gRPC 说话,状态全部落在 Postgres。
真正值钱的概念叫 durable task。普通任务崩了就崩了;durable task 只在三个位置打检查点:睡醒之后、等到事件之后、子任务结束之后。恢复时按事件日志重放,已经完成的步骤不会重跑,所以那次最贵的 LLM 调用不会被计两遍。
代价是约束很硬。durable 任务里只能干两件事:等(等时间、等事件)或者派子任务;而且给定事件历史,执行路径必须确定性——同一个输入重放两次,得走出同一条路。写的时候就得按这个前提设计,不能中途读随机数、读当前时间做分支。
上手
官方最短路径两条命令:
curl -fsSL https://install.hatchet.run/install.sh | bash
hatchet server start
它起的是 hatchet-lite:一个 postgres:15.6 加一个 hatchet-lite 容器,面板在 8888,gRPC 在 7077,默认账号 [email protected] / Admin123!!。自己机器上跑,第一件事是改密码,第二件事是别把 7077 直接暴露到公网——worker 靠它连引擎。
我拉了镜像的 manifest 看过,amd64 和 arm64 都有,A7Z、树莓派这类板子能直接起,这一点比不少只在 x86 上发镜像的平台省心。想认真上生产就别用 lite,官方写得很直白:lite 只适合开发和低流量,高吞吐的自托管要自己再挂一个 RabbitMQ,让 Postgres 专心当状态库。
跟 Agent 的关系
Hatchet 不是画布式平台,没有拖拽节点那一套,它管的是「Agent 跑起来之后可不可靠」。今年它往 Agent 这边挪了两步。
第一步是 MCP cookbook:把你的 workflow 注册成 Agent 的一个 tool,Agent 调一次,handler 就往引擎提交一个 run,worker 执行完把结果回传。好处是重试、限流、并发控制这些本来是给后台任务做的东西,Agent 调用直接白捡。
第二步是 11 月 9 日刚发的 sandbox 0.1.3(@hatchet-dev/sandbox):把第三方沙箱接进 durable task,每次 exec 既是一次任务、也对应一个快照,沙箱崩了能按 ID 接回来。不过官方文档自己写着:Hatchet 不提供原生代码沙箱隔离,隔离是你要做的基建决定,跟 OpenSandbox 那种专门做沙箱的底座不是一层东西。
实话
8,256 星放在 Agent 圈不算热,Dify 十六万、Langflow 十五万,它连零头都不到。但它解决的问题很具体,版本一直在推,不是那种发完发布会就安静的项目。
三个坑先说清楚:
- 高吞吐自托管要自己加 RabbitMQ。Postgres 既要存状态又要当队列,写入压力是实打实的,小机器上别指望它扛几千并发。
- 引擎和 SDK 是三条版本线:引擎 v0.114.2、Python SDK 1.45.1、Ruby 0.12.1 各发各的,装的时候两边都要 pin,随手拉 latest 容易撞上不兼容。
- 云版免费额度是每月 100 万 runs + 100 万 events,超了每百万 runs 收 30 美元、每百万 events 收 5 美元,数据只留 7 天。自托管 MIT 全免费,但机器、备份、升级都是你的事。
适合谁:已经在写 Agent 循环、被「重跑一次多花几美元」咬过、又不想上 Temporal 那一整套的人。不适合谁:想点两下就拖出一个 Agent 的,那还是去看 Dify 或者 Langflow,Hatchet 这边你得自己写代码。
一句话总结:它不帮你变聪明,只保证你摔了不用从山顶重来。