核心信息
Hermes Web UI 是 Hermes Agent 的 Web 管理仪表盘(5.1k Stars),提供 AI 聊天会话管理、用量监控、平台渠道配置、定时任务调度、技能浏览等功能,基于 Vue 3 + Koa 2 构建。
- 作者:EKKOLearnAI
- Stars:5.1k
- Forks:639
- 许可证:BSL-1.1
- 版本:v0.5.28(2026-05-17,51 个 Release)
- 技术栈:TypeScript 71.4% / Vue 25.0%(Vue 3 + Vite + Naive UI + Koa 2)
核心功能
| 功能 | 说明 |
|---|---|
| AI 聊天 | Socket.IO 实时流式聊天,多会话管理,Markdown 渲染,文件上传 |
| 平台通道 | 统一配置 8 个平台:Telegram/Discord/Slack/WhatsApp/Matrix/飞书/微信/企业微信 |
| 用量分析 | Token 消耗、会话数、成本、缓存命中率、模型分布、30 天趋势图表 |
| 定时任务 | Cron 任务管理,支持立即执行和快捷预设 |
| 模型管理 | 从凭证池自动发现模型,支持 OpenAI Codex 和 Nous Portal OAuth |
| 配置文件 | 多 Hermes 配置管理,克隆/导入/导出 |
| 文件浏览器 | 远程后端文件浏览(本地/Docker/SSH/Singularity) |
| 群聊 | 多智能体聊天室,@提及路由,上下文压缩 |
| 技能与记忆 | 浏览搜索已安装技能,用户笔记管理 |
| Web 终端 | 基于 node-pty + xterm 的集成终端 |
技术架构
Browser → BFF (Koa, :8648) → Hermes Gateway (:8642)
↓
Hermes CLI (sessions, logs, version)
后端通过 BFF(Backend For Frontend)层代理请求到 Hermes Gateway,读写 ~/.hermes/config.yaml 和 ~/.hermes/auth.json。
安装方式
npm install -g hermes-web-ui && hermes-web-ui start
# 或 Docker
WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d关联连接
- Hermes_Web_UI — 项目实体页面
- Hermes_Agent — Hermes Agent 核心项目(本 UI 是其管理界面)
- 摘要-hermes-agent — Hermes Agent 项目摘要