基于 Hermes Agent profile 机制构建的多 Agent 协作 Web 系统。每个 Agent 是一个独立的 Hermes profile，拥有独立的人设、技能、记忆与工具，通过 Web 中枢、MCP、ACP 与 Hermes Kanban 完成任务拆解、分派、执行、审查与汇总。
- 本项目是社区实验项目，不是 Nous Research 或 Hermes Agent 官方项目。
- 当前仅建议在本机或可信内网环境运行，不要在未加鉴权、访问控制和 HTTPS 保护的情况下直接暴露到公网。
- 所有 Agent profile、MCP、Skill、数据库与运行时配置均仅保存在本机环境中，项目不会将这些数据上传到云端，可放心在本地配置和使用。
- 系统实际能力取决于本机 Hermes Agent 所配置和调用的模型。
- 后端：Flask + Starlette/Uvicorn (ASGI)
- 通信协议：MCP（Agent → 中枢）+ ACP（中枢 → Agent）+ Hermes Kanban
- 存储：SQLite
- 前端：原生 HTML/JS，实时展示多 Agent 对话、终端输出与任务流转
更多设计细节见 doc/ARCHITECTURE.md 和 doc/design.md。
- Leader / Specialist 两层 Agent 角色，自动任务拆解、执行、审查与汇总
- Web UI 实时观察多 Agent 对话、终端输出、工具调用与子任务流转
- Hermes Kanban 看板任务、自动派发、状态同步与任务归档
- Agent 初始化、批量启动 / 停止 / 重启
- 模型配置管理，可为不同 Agent 应用不同模型配置
- 团队导入 / 导出，支持迁移 Agent profile、skills 与可选 workspace
- MCP Server 安装管理，支持
http/streamable_http/stdio - Skill 安装管理，支持从 frontmatter 解析元信息
- SOUL.md 人设编辑
app/ Flask 应用（controllers / services / models / db / static / templates）
asgi.py ASGI 入口，挂载 Flask + MCP Server
mcp_server.py 暴露给 Agent 的 MCP 工具
config.py 环境变量与路径配置
data/ SQLite 数据库（运行时生成，已 gitignore）
doc/ 架构 / 设计 / 管理文档
tests/ pytest 测试
run.py 本地开发启动入口
- 操作系统：Linux / macOS（依赖
pexpect，不支持原生 Windows；Windows 用户请使用 WSL2） - Python 3.10+
- 已安装并配置好的 Hermes Agent
- Hermes Agent v0.12.0 及以上版本，Hermes CLI 需要支持
profile、acp、kanban等子命令
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt| 变量 | 默认值 | 说明 |
|---|---|---|
HERMES_HOME |
~/.hermes |
Hermes profiles 根目录 |
AGENT_TEAM_WORKSPACE_ROOT |
~/agent_team |
Agent 工作区根目录 |
DATABASE_URL |
sqlite:///data/hermes_agent_team.db |
数据库连接串 |
HERMES_AGENTS_MCP_URL |
http://127.0.0.1:5050/mcp/ |
MCP Bus 地址 |
PORT |
5050 |
HTTP 服务端口 |
FLASK_DEBUG |
0 |
调试日志开关（不启用自动 reload） |
AUTO_START_AGENTS |
1 |
项目启动时自动启动所有已就绪 Agent；设为 0 可关闭 |
KANBAN_BOARD |
hermes-agents-team |
Hermes Kanban board 名称 |
KANBAN_POLL_INTERVAL |
2 |
Kanban 状态同步轮询间隔（秒） |
KANBAN_DEFAULT_WORKSPACE |
scratch |
Kanban 任务默认 workspace |
KANBAN_AUTO_DISPATCH |
0 |
首次无持久化设置时，自动 Dispatch 开关的默认值 |
需要关闭 Hermes Agent 的 config.yaml 中的 dispatch_in_gateway：
kanban:
dispatch_in_gateway: falsepython run.pypytest本项目作为开源项目发布，希望能为有需要的人提供参考和帮助。
由于个人时间和精力有限，本项目将以尽力而为的方式维护。我可能无法及时回复 Issue、审核 Pull Request，或提供持续的技术支持。
欢迎你根据自己的需要 Fork 本项目，并在此基础上自由修改和扩展。
- Leader Agent：
负责理解用户目标，拆解项目任务，选择合适的 worker 执行，并跟踪各环节结果。
- 产品 Agent：
负责把用户想法整理成清晰需求，定义功能范围、用户流程、优先级和验收标准。
- 开发 Agent：
负责根据需求完成技术方案、代码实现、接口设计等，不要做测试。
- 测试 Agent：
负责根据需求和实现设计测试用例，验证功能是否正确，并记录缺陷和风险。
- 设计 Agent：
负责页面结构、交互流程、视觉风格、组件规范和用户体验优化。
- 运维 Agent：
负责运行环境、部署流程、配置管理、日志排查、监控告警和上线风险控制。
发给 Leader Agent：
请大家做一个自我介绍
请组织团队分阶段协作，完成一个“待办清单”Web 项目。
目标：做成完整可用、适合快速演示的小功能，包含前端页面、后端接口和简单数据存储。页面风格是商务科技风格，风格要炫。使用未被占用的端口。
请严格分阶段执行：先只派产品 Agent 完成简短 PRD，并由 Leader review 通过后，才能派开发 Agent 实现前后端和存储；开发完成后再派测试 Agent 验证，测试 Agent 验证前必须先写测试用例文档再验证，再写测试报告。
完成标准：
1. 要有产品的 PRD 文档，开发的设计文档，开发的项目代码，测试的测试用例，和测试的测试报告。缺一不可，否则被定义为未完成
2. 务必在后台启动服务、确认可访问，并告诉我访问地址。
MIT
安全注意事项见 SECURITY.md。
MCP headers/env 等敏感字段会在界面展示和导出时做脱敏处理；运行所需的真实凭据仍保存在本机 Hermes profile 配置中，请不要提交或公开这些本地配置文件。