Hephaestus
让开发代理按发现动态生成并协调软件工作流。
- Star 数
- ★ 1.2k
- 最近更新
- 11 个月前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 软件团队拿到 PRD 后，希望把认证、REST API、前端、数据库和后台任务拆成可并行推进的工作时。
- 不适合
- 需要稳定生产环境的团队：项目仍处于 Alpha 阶段
- 希望快速上手的个人用户：需配置 Docker、Qdrant、Node.js 及多个 API 密钥
- 需要明确开源许可的团队：仓库标注 NOASSERTION，README 却称 AGPL-3.0
- 源码审查
- 42/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Hephaestus 是一个面向软件开发的半结构化代理框架，工作流由代理在执行中根据新发现扩展，而非预先写死全部分支。它以分析、实现和验证等 Phase 定义工作类型，并让代理动态创建带阻塞关系的 Kanban tickets。README 描述 Guardian 用于监控代理是否与阶段目标保持一致，并提供实时可观测性界面来查看隔离会话中的代理活动。代理可在 tmux 隔离环境中调用 Claude Code、OpenCode、Droid 或 Codex 等 CLI 工具；Qdrant 用作向量存储，另有 Node.js 前端。Hephaestus Dev 提供从 PRD 构建软件、修复缺陷、索引仓库、功能开发和生成文档五种预配置工作流。
用户先定义 Phase 及其完成条件，再由分析代理阅读任务或 PRD 并创建后续 tickets。实现和验证代理可以继续处理当前票据，同时根据测试失败、优化机会或其他发现，向任意 Phase 新增调查、修复、实现或复测 tickets，并通过 blocking relationships 协调依赖。Guardian 监控工作是否符合阶段指令；Kanban board、依赖图和可观测性视图展示形成中的工作流。Hephaestus 在 tmux 中运行所选的 Claude Code、OpenCode、Droid 或 Codex CLI，并要求配置 Hephaestus 与 Qdrant MCP servers。Hephaestus Dev 的入口命令为 python run_hephaestus_dev.py --path /path/to/project。
- 软件团队拿到 PRD 后，希望把认证、REST API、前端、数据库和后台任务拆成可并行推进的工作时。
- 维护者在现有 Git 仓库中修复缺陷，并希望将分析、修复和验证作为可追踪 tickets 协调时。
- 接手陌生代码库的开发者需要先扫描并建立内存中的代码库知识，再开始功能开发时。
- 测试人员在验证阶段发现性能机会或安全问题，并希望自动创建调查、实现和复测工作时。
- 需要为已有代码库生成较完整文档，并希望使用预配置开发工作流的团队。
如何安装或部署这个 Agent？
README 未提供克隆仓库、安装 Python/前端依赖或 .env 文件格式的命令，因此无法据此给出完整安装流程。已明确的前置条件是：Python 3.10+、tmux、Git、Docker、Node.js、npm，以及 Claude Code、OpenCode、Droid 或 Codex 之一；目标项目必须是 Git 仓库。还需要 API keys：OpenAI、OpenRouter、Anthropic，或 README 所列的 Azure OpenAI、Google AI Studio 支持路径之一；并需为 Hephaestus 和 Qdrant 配置 MCP servers。macOS 可运行 python check_setup_macos.py 检查 CLI、.env API keys、MCP、Docker/Qdrant 和依赖状态。
如何使用这个 Agent？
在满足前置条件并完成 MCP、LLM 配置后，对目标 Git 项目运行：python run_hephaestus_dev.py --path /path/to/project。该入口启动 Hephaestus Dev 的预配置开发工作流；README 未说明如何通过命令行选择五种具体工作流或传入 PRD，因此这些参数不能从现有证据中补充。
这个 Agent 有哪些优点和局限？
- 以 Phase 类型约束工作类别，同时允许代理根据发现动态创建任务，不需要预先定义每一条分支。
- Kanban tickets 和 blocking relationships 为并行开发、修复与验证提供了显式协调机制。
- Guardian 监控阶段对齐，配合实时可观测性和 tmux 隔离会话，便于观察多代理执行。
- Hephaestus Dev 已列出五种软件开发工作流，覆盖从 PRD 构建、仓库索引到缺陷修复。
- 运行环境较重：需要 Python、tmux、Git、Docker、Qdrant、Node.js、npm 和至少一种代理 CLI。
- 需要配置多项 API credentials 与 Hephaestus/Qdrant MCP servers；README 未给出完整安装命令或配置格式。
- 项目状态标为 Alpha，采用前应为运行稳定性和流程变更预留验证成本。
- 仓库元数据标注 License 为 NOASSERTION，而 README 声称 AGPL-3.0；许可状态需要在采用前单独核实。
这个 Agent 与同类方案有什么区别？
README 将其定位为介于传统预定义分支工作流与无结构代理之间：传统框架要求预先为分支编写指令，而 Hephaestus 允许代理在 Phase 结构内动态创建任务。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Hephaestus 当前 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.2k | 11 个月前 | Python | Codex · Claude Code · OpenAI API · Claude API |
| Whale | 56 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 931 | 25 天前 | Go | — |
| agentglass | 76 · 表现良好 | 桌面应用免费 + 模型费 | ★ 347 | 5 天前 | TypeScript | Codex · Claude Code |
| Agetor | 76 · 表现良好 | — | ★ 123 | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
代码展示了任务、记忆和结果的 API 模型，AGENTS.md 建议将密钥放在 .env 中；但所示 MCP 服务在启用 CORS 时允许任意来源并同时启用凭据，材料也没有证明认证、授权、敏感数据保护、用户确认或回滚机制，因此仅给有限分。依赖清单较多且范围不一，未提供可据以评估漏洞处置的证据。README 解释了项目构想，但来源归属和维护更新路径不够明确。
README、pyproject.toml 和 requirements.txt 对 Python 版本与依赖版本存在差异；静态材料没有展示锁定依赖或完整故障处理路径。请求模型限制了部分字段并定义了失败原因字段，但不足以证明服务各路径的一致性或错误反馈质量，故扣分。
README 给出软件开发、PRD 构建、缺陷修复等具体场景，阶段与动态任务机制也有清楚说明。材料没有清晰界定能力边界、动态任务触发的约束或不同部署环境的适配范围，环境要求还包括 tmux、Docker、Qdrant、Node 和外部 AI CLI，故未给满分。
README、AGENTS.md、项目目录说明和安装前提提供了较好的导航与起步信息，并附有示例工作流和帮助入口。根 AGENTS.md 的内容是贡献者指南而非产品指令。许可证文件明确为 AGPL-3.0，但元数据仍为 NOASSERTION；版本信息不一致，且材料没有充分说明已知限制、负责主体或维护更新路径，因此这些项只给有限分。
README 描述了动态创建任务、阶段协作、看板依赖和监控等可理解的预期用途，前端类型也显示了任务、代理、结果及验证状态等可操作数据。其价值主要由项目描述和类型定义支持，未有静态证据量化收益或投入成本；生产就绪表述与 Alpha 状态并存，因此扣分。
README 的主要主张可与部分接口模型和前端类型对应，但示例工作流及性能数字在所给材料中没有独立佐证。可见代码只截取了 MCP 服务的一部分，测试材料也仅提供了测试样例，不能据此确认运行结果。事实与宣传性推断没有始终明确区分，故各项仅给有限分。
- 所示服务启用 CORS 时允许任意来源并启用凭据；部署前应核实实际认证、授权和来源限制配置。
- README、pyproject.toml 与 requirements.txt 的 Python 及依赖版本信息不一致；安装环境可能与文档预期不同。
- README 的性能和工作流效果示例在所给源材料中未得到独立验证；本评估未执行代码或测试。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/hephaestus)<a href="https://followagents.com/zh/agents/hephaestus"><img src="https://followagents.com/badge/hephaestus.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
🔥 Hephaestus v0.0.1 - Initial Release The first official release of Hephaestus - a semi-structured agentic framework where AI workflows discover and create their own tasks as agents work. What is Hephaestus? Instead of predefining every task upfront, you define phase types (like "Analyze → Implement → Test"), and agents dynamically create tasks across these phases based on what they discover. A testing agent finds a bug? It spawns a fix task. Discovers an optimization? It spawns an investigation task. The workflow builds itself. --- ✨ Core Features …在 GitHub 查看 ↗
常见问题
它是否只能使用 Claude Code？
需要哪些模型或服务凭证？
它会直接修改任意目录吗？
测试发现问题后会怎样？
是否适合直接用于关键生产流程？
谢谢反馈，我们会据此改进页面。