Hermes Agents Team

基于 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           本地开发启动入口

快速开始

1. 环境要求

操作系统：Linux / macOS（依赖 pexpect，不支持原生 Windows；Windows 用户请使用 WSL2）
Python 3.10+
已安装并配置好的 Hermes Agent
Hermes Agent v0.12.0 及以上版本，Hermes CLI 需要支持 profile、acp、kanban 等子命令

2. 安装依赖

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. 配置环境变量（可选）

变量	默认值	说明
`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 开关的默认值

4. 配置调整

需要关闭 Hermes Agent 的 config.yaml 中的 dispatch_in_gateway：

kanban:
  dispatch_in_gateway: false

5. 启动

python run.py

访问 http://127.0.0.1:5050。

6. 运行测试

pytest

文档

维护说明

本项目作为开源项目发布，希望能为有需要的人提供参考和帮助。

由于个人时间和精力有限，本项目将以尽力而为的方式维护。我可能无法及时回复 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 配置中，请不要提交或公开这些本地配置文件。

Hermes Agent Team

README