Hephaestus

让AI代理自己搭建工作流，告别预设流程，动态完成任务。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 125 🐛 待处理 10 👀 关注 17

GitHub ↗

GitHub 星标 ★ 1185

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源框架，本地部署，完全免费

项目预览

项目数据

分类智能体

开发团队Ido-Levi

GitHubhttps://github.com/Ido-Levi/Hephaestus

定价模式🏷️完全免费

价格说明开源框架，本地部署，完全免费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型ai-agents,autonomous-agents,claude-code,llm

GitHub 星标★ 1185

上线时间2025-09-16 00:00:00

代码更新2025-12-01

仓库体积7.1 MB

本站数据更新2026-11-08

维护状态低维护

收录时间2026-08-09

浏览次数10

项目介绍

Hephaestus 是一个半结构化的智能体框架，旨在解决传统工作流中因预设流程而缺乏灵活性的问题。它允许代理在执行任务时自主发现需要完成的工作，并动态构建工作流，而非依赖预先定义的步骤。该框架基于 Python 构建，集成了 AI 代理、自主代理、Claude Code 和 LLM 等技术，提供了一种更适应复杂、动态环境的自动化解决方案。其核心能力包括：让代理自主规划任务路径、动态调整执行策略、以及支持与现有 LLM 生态的集成。Hephaestus 适合需要高度自适应和探索性的自动化场景，如复杂数据处理、自动化研究或动态业务流程管理。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1185

技术标签

ai-agents autonomous-agents claude-code llm

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 20 分钟部署方式：命令行工具 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 运行环境（用于执行仓库内的 .py 脚本）
已安装 CLI 工具：tmux、git、docker、node、npm、Claude Code
Docker 服务与 Qdrant 服务处于运行状态
项目根目录存在 .env 文件并填好所需 API 密钥
MCP 服务器已完成配置

安装与启动步骤

1获取项目代码

从 GitHub 拉取 Hephaestus 源码，后续所有脚本都需在项目根目录下执行。
```
git clone https://github.com/Ido-Levi/Hephaestus.git
cd Hephaestus
```
2检查环境配置

macOS 用户运行检查脚本，核对 CLI 工具、API 密钥、MCP、Docker 与 Qdrant 等是否就绪。
```
python check_setup_macos.py
```
3补齐 API 密钥

根据检查脚本的彩色报告，在 .env 中补上缺失的 API 密钥等配置后重新检查。
4运行开发工作流

启动 Hephaestus Dev，用 --path 指定目标项目路径，调用内置的开发类工作流。
```
python run_hephaestus_dev.py --path /path/to/project
```