EKKOLearnAI/hermes-web-ui
⭐ 4,238 · TypeScript · GitHub 仓库
Hermes Agent 网页控制面板 — 支持多平台 AI 聊天、会话管理、定时任务及使用分析
agent ai-agent chat-ui dashboard hermes hermes-agent hermes-web-ui llm
一句话总结
一款自托管网页仪表盘，为 Hermes Agent 统一管理多平台 AI 聊天、会话、分析与调度。
🔥 核心能力与独特卖点
- 统一的多平台聊天仪表盘： 在单一界面中管理来自 Telegram、Discord、Slack、WhatsApp、Matrix、飞书、微信和企业微信的对话。解决了在原生应用间切换上下文进行 AI 交互的痛点。
- 实时流式传输与会话管理： 基于 SSE 的流式聊天，支持多会话 CRUD、SQLite 存储以及跨对话的全局搜索。消除了上下文丢失和聊天历史碎片化的问题。
- 使用分析与成本追踪： Token 明细、缓存命中率、模型分布图表以及 30 天成本趋势。为自托管用户提供了通常缺失的支出和模型性能可见性。
- 定时任务与文件浏览器： 基于 Cron 的任务创建（支持触发执行），外加一个支持本地、Docker、SSH 和 Singularity 后端且具备完整 CRUD 功能的文件浏览器。自动化重复性任务，并集中管理异构环境下的文件。
- 多智能体群聊： 基于 Socket.IO 的房间，支持 @提及路由和上下文压缩。实现了多个智能体或用户在共享空间中协作的 AI 工作流。
独特卖点： 与 Hermes Agent 生态系统的深度集成，提供了独立的聊天 UI 或通用仪表盘无法比拟的连贯体验——频道配置、凭据管理和网关重启均可在一个管理界面中完成。
技术架构
| 层级 | 技术栈 | 角色 |
|---|---|---|
| 前端 | Vue 3 + TypeScript + Vite | 响应式 UI，包含位于 hermes/ 目录下的 Hermes 专用代码，以实现多智能体可扩展性 |
| BFF (Backend-for-Frontend) | Koa (端口 8648) | API 代理、SSE 流式传输、文件上传/下载、通过 CLI 进行会话 CRUD、配置/凭据管理、静态文件服务 |
| 网关 | Hermes Gateway (端口 8642) | 核心智能体路由与多平台集成 |
| 存储 | SQLite (本地) | 会话持久化与对话历史记录 |
| 实时通信 | Socket.IO | 群聊消息与实时更新 |
| 部署 | npm 全局包、Docker、一行 Shell 脚本 | 多种路径，满足不同运维偏好 |
架构亮点： BFF 模式将前端与网关直接访问解耦，实现了安全的凭据管理和多后端文件操作，而无需暴露内部服务。
快速入门指南
选项 1：npm 全局安装（推荐开发者使用）
bash
npm install -g hermes-web-ui && hermes-web-ui start选项 2：一行脚本（快速设置）
bash
bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)选项 3：Docker Compose（生产就绪）
bash
WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d hermes-agent hermes-webui用于管理的 CLI 命令：
bash
hermes-web-ui start --port 9000
hermes-web-ui stop
hermes-web-ui restart
hermes-web-ui status
hermes-web-ui update
hermes-web-ui -v
hermes-web-ui -h优点、缺点与用例
优点
- 功能全面，在一个仪表盘中覆盖聊天、分析、调度、文件管理和多平台支持
- 自托管且部署灵活（npm、Docker、一行脚本），完全掌控数据
- 实时流式传输和群聊功能，支持交互式工作流
- 丰富的配置和认证选项，满足企业级需求
缺点
- 与 Hermes Agent 生态系统紧密耦合——不能用作通用的 LLM 仪表盘
- 需要预先安装 Node.js 和 Hermes Agent
- Docker 设置需要额外配置环境变量才能用于生产环境
- 某些功能（如微信二维码登录）依赖第三方 API，存在可靠性隐患
谁不应该使用它？
- 未使用 Hermes Agent 的团队——此仪表盘专为 Hermes 生态系统构建，不能作为独立的聊天 UI 运行
- 寻求轻量级、单平台聊天界面的用户——对于单一渠道用例，多平台的复杂性会带来不必要的开销
- 需要云托管 SaaS 解决方案的组织——这是一个需要维护基础设施的自托管工具
理想用例
- 自托管的 AI 智能体团队，需要从单个仪表盘管理多个通信渠道（Telegram、Discord、Slack）
- 需要内部 LLM 部署的使用分析和成本追踪的 DevOps 团队
- 多智能体环境，其中具有 @提及路由和上下文压缩功能的群聊房间非常有价值
- 拥有异构文件存储（本地、Docker、SSH、Singularity）并需要统一文件浏览器访问的团队
社区与活跃度
拥有 4,238 颗星，并且开发活跃至 2026 年 5 月，Hermes Web UI 展现了强大的社区吸引力和持续的维护动力。该项目全面的文档、多种部署选项以及积极的功能开发（SSE 流式传输、Socket.IO 群聊、多后端文件浏览器）标志着一个健康且不断成长的生态系统。TypeScript 代码库和 Vue 3 架构吸引了现代 Web 开发者，而 CLI 工具和 Docker 支持则降低了运维人员的门槛。对于任何认真对待自托管 AI 智能体管理的人来说，这是一个值得关注——并且采用——的项目。