Hermes Web UI：强大的多平台 AI 代理 Web 管理面板（1.5K+ Stars）

Hermes Web UI：强大的多平台 AI 代理 Web 管理面板（1.5K+ Stars）

Hermes Web UI 是 Hermes Agent 的全功能 Web 管理面板。通过简洁、响应式的 Web 界面，你可以管理 AI 聊天会话、监控使用情况和成本、配置多平台通道、调度定时任务、浏览技能等。

这个项目由 EKKOLearnAI 开发，基于 Vue 3 + TypeScript 构建，为 AI 代理管理提供了可视化的解决方案，让开发者无需命令行就能轻松管理整个 Hermes Agent 生态系统。

惊人的数据

• GitHub Stars: 1,560+（截至 2026 年 4 月）
• Forks: 193+
• Open Issues: 49
• 语言: TypeScript
• 创建时间: 2026 年 4 月 11 日
• 最后更新: 2026 年 4 月 22 日

核心功能

💬 AI 聊天

• 实时流式输出：通过 SSE 实现异步流式响应
• 多会话管理：创建、重命名、删除、切换会话
• 会话分组：按来源（Telegram、Discord、Slack 等）分组，支持折叠展开
• 活跃会话标识：活跃会话固定到顶部并显示旋转图标
• 智能排序：按最新消息时间排序
• Markdown 渲染：支持语法高亮和代码复制
• 工具调用详情：展开查看参数和结果
• 文件上传：支持文件上传功能
• 全局模型选择器：从 `~/.hermes/auth.json` 凭证池自动发现模型
• 会话模型徽章：显示每个会话使用的模型和上下文 token 使用量

🔌 平台通道配置

在一个页面统一配置 8 个平台：

• Telegram：Bot token、提及控制、表情反应、自由响应聊天
• Discord：Bot token、提及、自动线程、表情反应、允许/忽略列表
• Slack：Bot token、提及控制、Bot 消息处理
• WhatsApp：启用/禁用、提及控制、提及模式
• Matrix：Access token、Homeserver、自动线程、DM 提及线程
• 飞书：App ID/Secret、提及控制
• 微信：二维码登录（浏览器扫码，自动保存凭证）
• 企业微信：Bot ID/Secret

特性：

• 凭证管理写入 `~/.hermes/.env`
• 通道行为设置写入 `~/.hermes/config.yaml`
• 配置变更时自动重启网关
• 检测每个平台的配置/未配置状态

📊 使用量分析

• 总 token 使用量分解（输入/输出）
• 会话数量及日均会话数
• 预估成本追踪和缓存命中率
• 模型使用分布图表
• 30 天每日趋势（柱状图 + 数据表格）

⏰ 定时任务

• 创建、编辑、暂停、恢复、删除 cron 任务
• 立即触发执行
• Cron 表达式快速预设

🤖 模型管理

• 从凭证池（`~/.hermes/auth.json`）自动发现模型
• 从每个提供商的端点（`/v1/models`）获取可用模型
• 添加、更新和删除提供商（预设和自定义 OpenAI 兼容）
• OpenAI Codex OAuth 登录以使用 Codex 模型
• 提供商级别的模型分组，支持默认模型切换

👥 多配置文件与网关

• 创建、重命名、删除和切换 Hermes 配置文件
• 克隆现有配置文件或从归档导入（`.tar.gz`）
• 导出配置文件用于备份或共享
• 多网关管理 —— 为每个配置文件启动、停止和监控网关
• 自动端口冲突解决
• 配置文件范围的配置和缓存隔离

🧠 技能与记忆

• 浏览和搜索已安装的技能
• 查看技能详情和附加文件
• 用户笔记和配置文件管理

📋 日志

• 查看代理 / 网关 / 错误日志
• 按日志级别、日志文件和关键字过滤
• 结构化日志解析，高亮显示 HTTP 访问日志

⚙️ 设置

• 显示：流式输出、紧凑模式、推理显示、成本显示
• 代理：最大轮数、超时、工具强制执行
• 记忆：启用/禁用、字符限制
• 会话重置：空闲超时、定时重置
• 隐私：PII 红色遮盖
• 模型设置：默认模型和提供商
• API 服务器配置

💻 Web 终端

• 集成终端，由 node-pty 和 @xterm/xterm 提供支持
• 多会话支持 —— 创建、切换和关闭终端会话
• 通过 WebSocket 实时键盘输入和 PTY 输出流式传输
• 窗口大小调整支持

快速开始

npm（推荐）

npm install -g hermes-web-ui
hermes-web-ui start

打开 http://localhost:8648

一键安装（自动检测操作系统）

自动安装 Node.js（如果缺失）和 hermes-web-ui，支持 Debian/Ubuntu/macOS：

bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)

WSL

bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)
hermes-web-ui start

WSL 自动检测并使用 `hermes gateway run` 进行后台启动（无需 launchd/systemd）。

Docker Compose

同时运行 Web UI 和 Hermes Agent：

# 使用预构建镜像（推荐）
WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d hermes-agent hermes-webui

# 或从源代码构建
docker compose up -d --build hermes-agent hermes-webui

docker compose logs -f hermes-webui

打开 http://localhost:6060

注意事项：

• 持久的 Hermes 数据存储在 `./hermes_data`
• Web UI 认证令牌存储在 `./hermes_data/hermes-web-ui/.token`
• 首次启用认证运行时，令牌会打印到容器日志
• 所有运行时设置由 `docker-compose.yml` 中的环境变量驱动

CLI 命令

自动配置

启动时 BFF 服务器自动：

• 验证 `~/.hermes/config.yaml` 并填充缺失的 `api_server` 字段
• 如果修改，将原始配置备份到 `config.yaml.bak`
• 检测并在需要时启动网关
• 解决端口冲突（终止旧进程）
• 启动成功后自动打开浏览器

开发

git clone https://github.com/EKKOLearnAI/hermes-web-ui.git
cd hermes-web-ui
npm install
npm run dev

• 前端: http://localhost:5173
• BFF 服务器: http://localhost:8648（代理到 Hermes 的 8642）

npm run build   # 输出到 dist/

架构

Browser → BFF (Koa, :8648) → Hermes Gateway (:8642)
                ↓
           Hermes CLI (sessions, logs, version)
                ↓
           ~/.hermes/config.yaml  (channel behavior)
           ~/.hermes/auth.json    (credential pool)
           Tencent iLink API      (WeChat QR login)

前端设计具有多代理可扩展性 —— 所有 Hermes 特定的代码都命名空间化在 `hermes/` 目录下（API、组件、视图、存储），使得在旁边添加新的代理集成变得简单。

BFF 层处理 API 代理（带路径重写）、SSE 流式传输、文件上传、通过 CLI 进行会话 CRUD、配置/凭证管理、微信二维码登录、模型发现、技能/内存管理、日志读取和静态文件服务。

技术栈

前端： Vue 3 + TypeScript + Vite + Naive UI + Pinia + Vue Router + vue-i18n + SCSS + markdown-it + highlight.js

后端： Koa 2（BFF 服务器）+ node-pty（Web 终端）

适用场景

• AI 代理开发者：需要可视化界面管理多个 AI 代理实例
• 多平台机器人运营：同时管理 Telegram、Discord、Slack、微信等多个平台的聊天机器人
• 团队协作：团队成员共享 Web 界面进行 AI 会话管理和监控
• 成本监控：实时跟踪 AI API 使用量和成本
• 技能管理：浏览和管理已安装的 AI 技能

项目链接

• GitHub: https://github.com/EKKOLearnAI/hermes-web-ui
• Hermes Agent: https://github.com/NousResearch/hermes-agent
• Stars: 1,560+
• License: MIT

总结

Hermes Web UI 是一个功能强大、设计精美的 AI 代理管理平台。它将复杂的命令行操作转化为直观的 Web 界面，让 AI 代理的管理变得简单高效。无论你是个人开发者还是团队用户，Hermes Web UI 都能为你提供便捷的多平台 AI 聊天管理、实时监控和配置管理能力。

如果你正在使用 Hermes Agent 或需要管理多平台 AI 聊天机器人，Hermes Web UI 绝对是值得尝试的工具。它的现代化界面和丰富的功能将大大提升你的工作效率。

cnbugsai

打赏 海报 链接