Heym
在自有基础设施上可视化构建、运行并审查 AI 工作流。
- 源仓库
- heymrun/heym
- Star 数
- ★ 1.4k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude.ai
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 运营团队需要把 webhook 输入、HTTP 调用、Slack 通知和 Redis/RabbitMQ 消息处理编排为一个可视化、可自托管的流程。
- 不适合
- 不想自行维护 Docker、PostgreSQL 等基础设施的团队
- 需要稳定生产版本、不能接受 pre-1.0 变更的用户
- 禁止挂载 Docker socket 或限制宿主机控制权的环境
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Heym 是一个自托管的 AI 原生工作流自动化平台,前端采用 Vue 3、TypeScript、Vite、Bun 和 Vue Flow,后端采用 Python、FastAPI、SQLAlchemy 与 PostgreSQL。用户可在拖放画布中连接 LLM、AI Agent、RAG、HTTP、消息队列、Playwright 和逻辑节点,图中独立节点会并行执行。工作流可从画布运行,也可通过 REST 执行端点、SSE 流、MCP 服务或 /chat/{slug} Portal 调用。平台提供执行历史、LLM trace、评测、日志、成本统计与 OpenTelemetry 导出,用于检查实际运行过程。部署边界是用户自己的 Docker 和数据库环境;README 还说明技能和 Codex 工作区通过受隔离的 sibling container 运行。
在画布上接收 Input(Webhook)、Cron 或 RabbitMQ Receive 等触发输入,按连线执行 LLM、AI Agent、Qdrant RAG、HTTP、Slack、Redis、RabbitMQ、Grist、Drive、Crawler 与 Playwright 节点,并通过 Merge、Condition、Switch、Loop 和 Error Handler 控制流程。AI Agent 节点可调用工具、画布节点工具、沙箱化 Python 工具、MCP 连接和技能;技能由 SKILL.md 与可选 Python 文件组成。工作流可经 /execute 或 /execute/stream 调用,也可作为 /api/mcp/sse 上的 MCP 工具或 /chat/{slug} 上带流式响应和文件上传的聊天界面发布。系统保存运行历史、节点调试日志、请求与响应、工具调用、token 与美元成本,并可将工作流、节点和 Agent 工具 span 经 OTLP/HTTP 导出。
- 运营团队需要把 webhook 输入、HTTP 调用、Slack 通知和 Redis/RabbitMQ 消息处理编排为一个可视化、可自托管的流程。
- AI 产品团队需要用 RAG 节点检索托管向量库中的 PDF、Markdown、CSV 或 JSON,再将结果送入 LLM 或 Agent。
- 需要人工审批的业务团队可让 Agent 在执行中暂停,收集批准、澄清或输入后继续。
- 内部工具团队需要把既有工作流发布为
/chat/{slug}聊天入口,提供流式回复、上传文件和可选认证。 - 使用 Claude Desktop、Cursor 或其他 MCP 客户端的团队可将已完成工作流暴露为 MCP 工具。
- 需要自动化网页操作的团队可用 Playwright 节点执行浏览器步骤,并使用 Auto Heal 处理失效选择器。
如何安装或部署这个 Agent?
前提条件为 Docker、Python 3.11+、Bun 1.0+ 和 UV。克隆并启动:
git clone https://github.com/heymrun/heym.git && cd heym && ./run.sh启动后在浏览器打开端口 4017。使用配置文件时执行 cp .env.example .env 后运行 ./run.sh;该脚本会生成 SECRET_KEY 和 ENCRYPTION_KEY。生产 Docker 部署可执行 cp .env.example .env、./deploy.sh。
如何使用这个 Agent?
打开 4017 的编辑器,在画布中添加 Input、LLM 或 AI Agent 与 Output 节点并连接它们,然后从画布执行工作流。要由外部服务调用同一流程,可使用文档列出的 /execute 或 /execute/stream 端点;要供 MCP 客户端调用,可暴露为 /api/mcp/sse;要生成聊天入口,则发布到 /chat/{slug}。Agent 需要外部能力时,在节点中配置 MCP 连接或上传/创建包含 SKILL.md 的技能。
这个 Agent 有哪些优点和局限?
- 同一工作流可通过画布、REST、SSE、MCP 和 Portal 聊天界面交付,无需为每种入口重建逻辑。
- 工作流 DAG 会让独立节点并行运行,并以 Merge 节点同步分支。
- 内置运行历史、LLM trace、评测、token/美元成本和 OpenTelemetry span 导出,覆盖开发与生产检查。
- Agent 节点将工具调用、沙箱化 Python、MCP、技能和可选持久记忆图组合在一个画布节点中。
- 运行需要 Docker、PostgreSQL、Python、Bun 和 UV;部署与运维并非纯托管式体验。
- README 指出 Docker socket 挂载会授予广泛的主机控制能力;MCP stdio 服务器依赖 Docker daemon,缺失时会失败关闭。
- 每次运行的沙箱隔离要求 Docker Engine 25.0+,并且技能与 Codex 节点依赖共享的
heym-codex-workspaces卷。 - 许可信息存在需核实之处:仓库元数据标为
NOASSERTION,README 则称 MIT 附 Commons Clause,并限制销售或作为付费服务提供。
这个 Agent 与同类方案有什么区别?
README 将 Heym 与 n8n、Zapier 和 Make.com 对比,重点列出其 LLM Batch API 状态分支、Agent 持久记忆图、工作流分析器、工作流驱动仪表盘、内置 Agentic Kanban、技能系统、Playwright Auto Heal、原生 OpenTelemetry 和按美元计的模型成本追踪。该比较是仓库自身的功能主张;实际迁移前应分别验证所需集成和许可条件。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Heym 当前 | 63 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 1.4k | 今天 | Python | Codex · Claude.ai |
| Auto Browser | 76 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 924 | 1 天前 | Python | OpenAI API · Claude API |
| Flow-Like | 74 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 976 | 今天 | Rust | — |
| ByteChef | 57 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 1.1k | 今天 | Java | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安全策略列出私有漏洞报告、禁止在未授权实例测试,并披露 Docker socket 会赋予广泛主机控制权;AGENTS.md 还规定密钥哈希、脱敏和凭据返回边界,因此用户确认与敏感数据处理有实质依据。扣分原因:部署示例仍需挂载 Docker socket,材料未展示具体权限隔离实现;外部集成、插件和代码执行面广,静态摘录不足以证明最小权限、回滚或依赖安全已充分落实。LICENSE 同时附加 Commons Clause,且仓库归属可追溯到具名许可方,但这不足以证明授权者身份已验证。
README、启动说明、运行时和 CI 片段在 PostgreSQL、自托管、Python/FastAPI 与前端架构上基本一致;CI 配置了 lint、类型检查、单元测试、构建和 E2E 工作。扣分原因:样本没有依赖锁文件或服务可用性策略,启动中 Playwright 安装失败仅记录警告,插件依赖重装失败也不阻塞启动;故无法给依赖可用性高分。
材料明确覆盖可视化和 AI 构建、确定性工作流、多代理、API、定时任务、事件触发、MCP、Portal、集群和自托管等场景,并说明部分工作流在主实例执行、部分后台任务可分发。扣分原因:对各类运行时能力的权限边界和不支持情形交代有限;环境配置指向专门变量文档,但该文档内容不在样本中。
README 提供分层产品说明、快速启动、部署、扩展路径和节点分类;安全策略、部署文档链接、版本发布路径及前置条件也有说明。扣分原因:MIT 文本附加 Commons Clause,许可条件不是单纯 MIT;样本未包含完整变更日志或维护者响应责任细节,且前置版本系列为 pre-1.0。
产品说明给出工作流可执行、检查、评估、暂停审批、追踪成本并通过 API/MCP/Portal 暴露的具体输出路径,示例提示词和产品演示便于理解。扣分原因:能力广泛意味着配置、维护和基础设施成本不低,材料没有量化成本收益或资源需求,因此成本效益仅获低分。
README 的主要功能主张可与后端入口、前端路由、CI、安全策略和测试辅助代码部分互证;CI 工作流确实列出自动检查步骤。扣分原因:这些样本不能独立验证功能运行结果,且许多宣称对应的实现文件未提供;本评估不把静态材料表述为已执行验证。
- 部署示例挂载 Docker socket;README 明确说明这会授予广泛主机控制权,应仅在受控部署中开放。
- 许可证包含 Commons Clause,商业托管或支持服务的权利可能受限制;部署前应审阅完整许可条款。
- 样本不足以确认插件、MCP、浏览器自动化及外部集成的实际安全边界或运行表现。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * docs(security): describe Fernet as AES-128-CBC with HMAC-SHA256 by @mbakgun in https://github.com/heymrun/heym/pull/874 * Show Settings tabs as a left rail and explain key rotation in numbered steps by @ckakgun in https://github.com/heymrun/heym/pull/875 * Edit a sent chat message and send it again by @ckakgun in https://github.com/heymrun/heym/pull/876 * Two-factor sign-in, account deactivation and data retention by @mbakgun in https://github.com/heymrun/heym/pull/877 * Bump project version to 0.0.150 by @heym-coder in https://github.com/heymrun/heym/pull/878 …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * chore(docker): drop build leftovers from the release and backend images by @amasolov in https://github.com/heymrun/heym/pull/870 * feat(credentials): credentials from Kubernetes Secrets (#861) by @amasolov in https://github.com/heymrun/heym/pull/867 * feat(encryption): online rotation for ENCRYPTION_KEY by @amasolov in https://github.com/heymrun/heym/pull/871 * Bump project version to 0.0.149 by @heym-coder in https://github.com/heymrun/heym/pull/873 …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Implement Google Meet integration with OAuth support by @ckakgun in https://github.com/heymrun/heym/pull/866 * Add optional Google Meet busy event titles by @mbakgun in https://github.com/heymrun/heym/pull/869 * Bump project version to 0.0.148 by @heym-coder in https://github.com/heymrun/heym/pull/868 Security …在 GitHub 查看 ↗
常见问题
Heym 可以部署在自己的基础设施上吗?
./run.sh、./deploy.sh 和 Docker 运行方式,并将其定位为自托管产品。如何把工作流交给 Claude 或其他 AI 客户端调用?
/api/mcp/sse;README 明确提到 Claude Desktop、Cursor 和其他 MCP 客户端。运行失败时能否查看执行细节?
运行 MCP stdio 或技能有什么基础设施要求?
谢谢反馈,我们会据此改进页面。