Hermes Studio
将 Hermes Agent 的聊天、工作流与本地运行管理集中到一个自托管工作台。
- Star 数
- ★ 12k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- TypeScript
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要在本机运行 Hermes Agent 的个人用户，可用持久化会话、工具调用轨迹和生成文件预览完成日常代理对话。
- 不适合
- 只想用浏览器打开、不愿安装桌面端或自托管服务的用户
- 需要电话语音或常开唤醒词语音助手的场景
- 源码审查
- 44/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Hermes Studio 是 Hermes Agent 的桌面应用、本地运行环境与 Web 控制台，前端采用 Vue 3，后端为 Koa BFF 服务。它通过 Socket.IO 的 /chat-run 和 Hermes agent bridge 执行流式对话，并把会话、文件、模型、凭据和运行设置纳入配置化管理。除聊天外，它提供可视化工作流、定时任务、看板、群聊、终端、文件浏览器、语音以及 Claude Code 和 Codex 的运行与监控界面。产品可作为 Windows、macOS、Linux 桌面应用发布，也可通过 hermes-web-ui npm CLI 或 Docker Compose 自托管。它适合希望保留本地数据和 Hermes profile 控制权，同时需要多渠道与多模型操作界面的团队或个人。
浏览器调用 Koa BFF 的 Socket.IO /chat-run，BFF 启动或连接 Hermes agent bridge，再由 bridge 调用 Hermes Agent runtime、Hermes CLI 与所选 profile。控制台读取和维护 profile 的 config.yaml、auth.json、本地 Web UI SQLite 会话库及上传目录；可发现 provider 的 /v1/models，管理 OpenAI 兼容 provider、模型可见性与 OAuth/device 登录。它能在本地、Docker、SSH、Singularity 后端浏览和操作文件，预览生成的 HTML、PDF、DOCX、PPTX、XLSX、CSV、图片和源码；也能建立 Vue Flow 工作流、cron 作业、Kanban 任务与 Socket.IO 群聊。桌面版还通过 hermes-studio-mcp [api|browser|devices|use] 提供受管 MCP 工具集，并包含由 node-pty 和 @xterm/xterm 支撑的 Web 终端。
- 需要在本机运行 Hermes Agent 的个人用户，可用持久化会话、工具调用轨迹和生成文件预览完成日常代理对话。
- 需要同时维护 Telegram、Discord、Slack、WhatsApp 等渠道配置的管理员，可在一个页面写入各 Hermes profile 的渠道行为与凭据。
- 要把 Hermes、Codex 与 Claude Code 串成有审批、循环和成功/失败分支流程的团队，可在 Vue Flow 画布中运行并回放执行证据。
- 需要在 Docker、SSH 或 Singularity 工作区取回代理产物的开发者，可按路径下载文件、编辑支持的文本文件并重新附加到聊天。
- 需要跟踪本地代理工作量的负责人，可查看 token 输入输出、成本估算、缓存命中率和 30 天使用趋势。
如何安装或部署这个 Agent？
npm 全局安装并启动：
npm install -g hermes-web-ui
hermes-web-ui start然后打开 http://localhost:8648。首次运行会生成认证 token；也可设置 AUTH_TOKEN。用户名密码登录的默认引导账号为 admin / 123456，登录后应按界面提示修改。Docker 部署可执行：WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d，然后访问 http://localhost:6060。后端聊天功能需要可发现的 Hermes Agent 源码目录（含 run_agent.py），否则会回退到已安装的 hermes 命令所用 Python 或系统 Python。
如何使用这个 Agent？
启动后选择获授权的 Hermes profile，并在 Models 中配置或发现 provider 与模型；使用 OAuth/device 流程时按对应 provider 完成登录。新建会话后发送消息，流式结果和工具细节会经 /chat-run 显示；可上传文件或将工作区文件附加到对话。需要自动化时，在工作流画布添加 Hermes、Codex 或 Claude Code 节点，配置连接、条件和审批，再运行或重跑；定时任务可在 Scheduled Jobs 中设置 cron。若要只暴露所需 MCP 能力，使用 hermes-studio-mcp api、browser、devices 或 use。
这个 Agent 有哪些优点和局限？
- 将聊天、profile、模型、渠道、会话、文件和运行日志整合在同一套本地控制面中，而非只提供聊天界面。
- 文件操作覆盖本地、Docker、SSH 与 Singularity，并支持代理生成产物的路径下载和多种文档预览。
- 可视化工作流不仅连接节点，还记录运行快照、节点对话、边决策与证据回放。
- 同时提供桌面版、npm CLI、Docker Compose 和受管 MCP 工具集，适应本机与自托管部署。
- 聊天执行依赖 Hermes Agent runtime 与 bridge；找不到源码 checkout 时需要依赖已安装的
hermes命令或系统 Python。 - 默认引导账号为
admin/123456，部署者必须在首次登录后修改，且需妥善处理 token、JWT secret 和 provider 凭据。 - 模型发现、OAuth/device 登录和
/v1/models获取受各 provider 的端点、凭据和兼容性影响。 - 实时语音舞台明确不支持同时全双工听说，也不涵盖电话式或始终监听的唤醒词模式。
这个 Agent 与同类方案有什么区别？
相较于直接使用 Hermes Agent CLI，Hermes Studio 在同一 Hermes profile 与运行时之上增加了 Web/桌面聊天、会话数据库、可视化工作流、渠道配置、文件界面和运行监控；它并不替代底层 Hermes Agent runtime。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Hermes Studio 当前 | 44 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 12k | 今天 | TypeScript | Codex · Claude Code · OpenAI API |
| Hermes Web UI | 51 · 缺口较多 | 网页应用免费 + 模型费 | ★ 19k | 今天 | Python | Codex · Claude Code · OpenAI API · Claude API |
| Presenton——开源 AI 演示文稿生成器与 API | 56 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 12k | 1 天前 | TypeScript | — |
| AgentRQ | 64 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 1.2k | 1 天前 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 描述了认证机制（token、用户名/密码、默认凭据 admin/123456），并提示用户更改默认密码；敏感数据（如 API 密钥）存储在 ~/.hermes/.env，且声称密钥仅保留在服务端。但未提供代码级证据证明最小权限原则、用户确认机制或数据流透明性。依赖安全方面，package.json 列出了依赖，但未提供漏洞扫描或审计证据。外部影响方面，README 提到自动更新、MCP 注入等，但未说明用户确认。回滚方面，有更新命令，但未提供回滚机制。来源归属方面，仓库有明确的作者和许可证，但发布者未经验证。因此，多数标准仅得 1 分，因为证据存在但薄弱或仅声明。
证据显示：README 和 package.json 中的描述一致，测试文件存在，表明一定的一致性。但依赖可用性方面，依赖列表广泛，但未提供锁定文件或完整性校验。失败消息方面，测试覆盖了错误处理，但未提供用户友好的错误消息证据。因此，自洽性得 2 分，其他得 1 分。
证据显示：README 描述了多种使用场景（桌面、npm、Docker），并提供了环境变量和 CLI 命令，表明对多种环境的适应性。能力边界方面，README 列出了功能和非目标（如语音对话文档），但未详细说明限制。触发精度方面，未提供具体触发条件。因此，受众和场景、能力边界、环境适配得 2 分，触发精度得 1 分。
证据显示：README 结构清晰，提供了安装说明（桌面、npm、Docker），许可证为 BSL-1.1，版本号在 package.json 中。但命名稳定性方面，项目从 Hermes Web UI 更名为 Hermes Studio，可能影响稳定性。示例和 FAQ 方面，README 提供了快速开始，但缺少 FAQ。已知限制方面，仅在语音对话文档中提及非目标。版本变更日志方面，未提供 CHANGELOG。维护责任方面，有 GitHub Actions 工作流，但未明确维护者。因此，信息架构、安装说明、许可证得 2 分，其他得 1 分。
证据显示：README 描述了丰富的功能，输出可用性方面，提供了多种输出格式（如文件预览）。边际价值方面，提供了多平台集成和自动化，可能增加价值。成本效益方面，未提供性能或资源使用数据。因此，输出可用性和边际价值得 2 分，成本效益得 1 分。
证据显示：README 中的声明部分有测试支持（如 API 测试），但未提供所有声明的可追溯性。跨来源佐证方面，仅依赖仓库内部证据。事实与推断分离方面，未明确区分。因此，所有标准得 1 分。
- 默认凭据 admin/123456 存在安全风险，用户必须立即更改。
- 依赖安全未提供审计证据，建议检查依赖漏洞。
- 发布者未经验证，需谨慎评估供应链风险。
- 项目更名可能影响文档和命令的稳定性。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.8.17 Ekko Studio v0.8.17
发布说明摘录
更新内容 1. 修复 Bot 派发后台任务后没有回复并误报“Agent returned no output”的问题；等待前正常生成、流式发送并保存回复，后台结果仍自动回传，任务与协作阶段保持进行中，达到步骤上限也能完成本轮收尾 (#3699) 2. 等待后台任务时不再误触发完成铃声、完成通知或 App 完成推送，直接发送与恢复会话保持一致；保留防重复查询和结果回传去重，供应商返回空正文或违规工具调用时仍明确报错 (#3699) 3. 个人 Bot 消息标题优先显示用户自定义名称，重命名后已有消息和新回复同步更新，重载后保留；未命名时使用本地化预设名称，头像与动画继续对应所选 Bot 外观 (#3700) 涉及 PR：#3699、#3700；发版准备 PR：#3702。在 GitHub 查看 ↗ -
v0.8.16 Ekko Studio v0.8.16
发布说明摘录
Ekko Studio 0.8.16 更新日志 日期：2026-11-05 1. 群聊页面新增一次性停用与迁移提示，建议将现有工作转到 Bot；确认后在同源浏览器或桌面端记住并同步到其他标签页，不指定停用日期，也不自动迁移数据 (#3693) 2. Bot 等待后台任务时由宿主暂停当前回合，减少重复查询耗尽模型步数；无浏览器连接时仍处理结果回传，并恢复中断、启动前停止及重启后的终态通知 (#3690) 3. 任务详情中的人工续聊直接在原任务追加，无需先等待协调模型判断；结果回传携带本轮人工指令和附件，帮助 Bot 按最新要求理解结果，关联验收也保留该上下文 (#3691) 4. 完善多轮 Bot 协作、阶段完成确认与停止状态恢复，保留原始结果并限制状态确认重试；允许当前协作 Bot 继续未完成任务，同时保留已完成同伴、路由、轮次和过期回调隔离 (#3675, #3680) 5. 独立验收期间活动胶囊仅显示当前执行者；验收通过后同时展示开发与验收任务卡，各自打开对应执行，实时消息与重载历史保持一致 (#3682) 6. 切换 Bot 或 Agent 对话时保留面板、宽度、工具页签及各 Bot 的 Agent 选择，工作区按用户显式开关保持；统一面板顺序、任务 Agent 身份和浏览器定位，并防止过期读取覆盖当前内容 (#3676) …在 GitHub 查看 ↗ -
v0.8.15 Ekko Studio v0.8.15
发布说明摘录
Ekko Studio 0.8.15 更新日志 日期：2026-11-04 1. 修复工作流新节点选择 Agent 或编辑标题后消失的问题，避免旧尺寸覆盖画布状态，并保持连线新建与撤销行为一致 (#3670) 2. 定时任务展示账户内所有 BOT 的计划，不再截断为 50 条；增加所属 BOT 头像、名称、目标预览及完整指令、时间表达式、时区、状态和下次执行详情，跨 BOT 编辑保留原归属和后台任务名称 (#3663) 3. 修复 OpenAI 兼容接口流式工具调用续传空 id 或函数名时丢失已知身份、误报 invalid_tool_call 的问题，保留参数拼接与缺失身份校验 (#3647) 4. 群聊路由未选择目标 Agent 时不再误报“交接信息可能不完整”；已选择 Agent 的交接提醒保持原有规则 (#3626) 5. 前端更新日志仅保留最近三个版本，同步精简全部 12 种语言的旧日志条目 (#3662) 6. 更新中英文 README 产品截图，展示实际运行界面的新建对话 Agent 轮播、可视化工作流和完整 Agent 管理器，移除过期示例图 (#3661) 7. 开发与 CI 的任务报告及测试产物改为存放在仓库 worktree 之外，新增目录管理命令和只读位置检查，并同步覆盖率、浏览器报告及上传路径；检查不会自动删除文件 (#3657) …在 GitHub 查看 ↗
常见问题
数据主要存在哪里？
HERMES_WEB_UI_HOME（默认 ~/.hermes-web-ui）；Hermes 数据默认位于平台对应的 HERMES_HOME。可以使用自定义模型服务吗？
/v1/models 获取模型；可用性仍取决于该服务的端点和凭据。Docker 首次启动如何认证？
./hermes_data/hermes-web-ui/.token。是否可以不让 Web UI 管理 Hermes gateway？
HERMES_WEB_UI_MANAGED_GATEWAY=0，改由 hermes gateway start 管理；也可设置 HERMES_WEB_UI_DISABLE_GATEWAY_AUTOSTART 跳过自动启动检查。