EKKOLearnAI/hermes-studio: Web dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics

Hermes Studio English

面向 Hermes Agent 的桌面应用、本地运行时和 Web 控制台。
聊天、模型与 Profile 管理、平台渠道接入、任务自动化、
文件查看、Coding Agent 和本地运行环境都在一个界面中完成。

下载 Hermes Studio 桌面版 · npm install -g hermes-web-ui && hermes-web-ui start

移动端

核心能力 #

功能特性 #

AI 聊天 #

• 聊天前端通过 Socket.IO /chat-run 实时流式更新；聊天运行通过 Hermes agent bridge 执行
• 多会话管理 — 创建、重命名、删除、切换会话
• 自建会话数据库 — Web UI 会话使用本地 SQLite；Hermes state.db 仅作为只读来源用于 Hermes 历史 API
• 按来源分组会话（Telegram、Discord、Slack 等），可折叠手风琴面板
• 活跃会话实时指示器 — 正在进行的会话置顶并显示旋转图标
• 按最新消息时间排序会话列表
• Markdown 渲染，支持语法高亮和代码复制
• 工具调用详情展开（参数 / 结果）
• 按 Profile 隔离的文件上传
• 文件下载支持 — 按解析后的路径下载用户上传文件和 Agent 生成文件，兼容 local、Docker、SSH、Singularity 等多种 terminal backend
• 会话搜索 — Ctrl+K 搜索 Web UI 本地会话库；不包含只读 Hermes 历史会话
• 按账号授权 Profile 汇总模型选择器 — 只展示当前账号可访问的 Hermes Profile 中可用的模型
• 每个会话显示模型标签和上下文 Token 用量

平台渠道 #

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

• 凭证管理写入 ~/.hermes/.env
• 渠道行为设置写入 ~/.hermes/config.yaml
• 每个平台已配置/未配置状态检测

用量分析 #

• Token 总用量明细（输入 / 输出）
• 会话数及日均统计
• 预估费用追踪及缓存命中率
• 模型使用分布图
• 30 天每日趋势（柱状图 + 数据表格）

定时任务 #

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

Kanban #

• 按 Profile 管理的 Kanban 看板，用于规划和跟踪 Agent 工作
• 可在仪表盘中创建任务、更新任务并移动状态
• 复用 Web UI 本地状态和认证体系

模型管理 #

• 从凭证池自动发现模型（ ~/.hermes/auth.json ）
• 从每个 Provider 端点获取可用模型（ /v1/models ）
• 添加、更新、删除 Provider（预设 & 自定义 OpenAI 兼容）
• OpenAI Codex 和 Nous Portal OAuth 登录
• Provider URL 自动检测，支持非 v1 API 版本（如 /v4 ）
• Provider 级别模型分组，支持切换默认模型

多配置文件 #

• 创建、重命名、删除、切换 Hermes 配置文件（Profile）
• 克隆现有配置文件或从归档导入（.tar.gz ）
• 导出配置文件用于备份或分享
• 按 Profile 隔离配置、缓存、上传、会话、任务、用量、记忆、技能、插件、Provider 和模型可见性
• 账号绑定 Profile 权限：超级管理员可以管理全部 Profile；普通管理员只能查看和使用分配给自己的 Profile

文件浏览器 #

• 浏览远程后端文件（local、Docker、SSH、Singularity）
• 上传、下载、重命名、复制、移动和删除文件
• 上传文件保存到当前选择/请求的 Hermes Profile 目录下；下载按真实路径解析，支持下载上传目录外的 Agent 产物
• 创建目录
• 查看文件内容，支持语法高亮

群聊 #

• 多 Agent 聊天房间，通过 Socket.IO 实时通信
• @提及路由 — 提及 Agent 触发上下文回复
• 上下文压缩 — 历史消息超过 Token 阈值时自动摘要压缩
• 输入状态和回复进度指示器
• 房间创建、删除和邀请码管理
• Agent 管理 — 添加/移除房间中的 Agent，支持独立 Profile
• SQLite 消息持久化
• 移动端响应式布局，可折叠侧边栏

Coding Agents #

• 在 Web 仪表盘中启动和监控本地 Coding Agent 会话
• 为 Codex 和 Claude Code 集成提供独立代理路由
• 持久化 Agent 输出和 reasoning 元数据，便于后续查看

技能与记忆 #

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

日志 #

• 查看 Agent / Server / Error 日志
• 按日志级别、日志文件和关键词过滤
• 结构化日志解析，HTTP 访问日志高亮

管理与运行时 #

• 设备和局域网 Peer 页面，用于本地网络发现和 Peer 工具能力
• MCP 管理器，用于托管的 hermes-studio MCP Server 和 Profile 自动注入
• Runtime Version 和 Version Preview 工具，用于隔离测试新版本
• 面向超级管理员的性能监控视图

认证 #

• 基于 Token 的认证（首次运行自动生成或通过 AUTH_TOKEN 环境变量设置）
• 用户名/密码登录，并在设置页提供账户管理
• 默认登录名/密码为 admin / 123456 ；登录后会提示尽快修改默认账户和密码
• 超级管理员可以管理用户和 Profile 绑定；普通管理员只能管理自己的账户信息

CLI 维护命令：

# 删除持久化的登录 IP 锁记录
hermes-web-ui clear-login-locks

# 删除登录锁并重启正在运行的 Web UI 进程
hermes-web-ui clear-login-locks --restart

# 创建或重置默认超级管理员登录名/密码为 admin / 123456
hermes-web-ui reset-default-login

clear-login-locks 会删除 ${HERMES_WEB_UI_HOME:-~/.hermes-web-ui}/.login-lock.json 。如果服务正在运行，需要重启服务才能清理内存中的锁定状态。 reset-default-login 会更新 Web UI 账户数据库；如果已存在 admin 用户，则会把密码重置为 123456 ，并启用为超级管理员账户。

设置 #

• 显示（流式输出、紧凑模式、推理过程、费用显示）
• Agent（最大轮次、超时时间、工具强制执行）
• 记忆（启用/禁用、字符限制）
• 会话重置（空闲超时、定时重置）
• 隐私（PII 脱敏）
• 模型设置（默认模型 & Provider）
• Profile 和 Provider 配置

语音 / TTS / STT #

• 可在聊天和群聊消息中朗读 Assistant 回复。
• Provider 支持：浏览器 Web Speech、内置 Edge TTS、OpenAI 兼容 /audio/speech 、自定义 OpenAI 兼容 TTS 端点、MiMo。
• MiMo 支持预置音色、音色设计提示词、音色复刻参考音频（.mp3 /.wav ，最大 10 MB），并可选择鉴权请求头模式（ Authorization 、 api-key 或两者同时发送）。
• Edge / OpenAI 兼容 / 自定义 / MiMo 播放统一走 Web UI 后端 /api/hermes/tts/synthesize ，停止/暂停状态一致，并会在可行时中断进行中的 fetch。
• Provider API Key 和 MiMo 复刻参考音频保存在服务端 TTS 设置中，浏览器只显示脱敏后的 secret 状态。
• 使用 OpenAI / 自定义 / MiMo 播放前，先在 Settings → Voice 保存 provider 设置。消息播放只发送文本和非敏感播放参数，后端合成时读取当前用户保存的私钥。
• 聊天输入框支持回合制语音输入：通过麦克风按钮开始/停止一轮录音，转写结果会先填入当前输入框，用户可以编辑后再用普通发送按钮发送。
• 语音输入 / STT 可在支持时使用浏览器语音识别，也可使用在 Settings → Voice 中配置的服务端 provider。
• 当 Assistant 音频正在播放时，开始新的语音输入会先停止播放。这个 barge-in 只打断音频，不会隐式取消正在运行的 Agent；停止 run 仍然需要显式操作。
• 支持的设置项、安全边界和当前非目标范围见 docs/voice-dialogue.md 。
• 限制：浏览器/服务端中断后，外部 TTS Provider 仍可能继续处理请求；自定义 / OpenAI 兼容 / MiMo base URL 必须是公网 http / https 端点，不能指向 localhost 或私网。

Web 终端 #

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

桌面应用与自动更新 #

• Windows、macOS 和 Linux 原生 Electron 桌面壳
• 内置 Web UI 运行时，并自动启动本地 Hermes Studio 服务
• 桌面自动更新优先使用 Cloudflare 下载端点获取更新元数据和安装包
• 如果 Cloudflare 更新源不可用，会回退到 GitHub Releases latest 资源
• Windows 升级时会先尝试关闭已有 Hermes Studio 进程，再替换文件

快速开始 #

桌面应用（推荐） #

从 GitHub Releases 下载最新的 Hermes Studio 桌面安装包。

桌面版会发布 macOS、Windows 和 Linux 构建；适用时会区分不同 CPU 架构。 桌面应用内置 Web UI 运行时，Hermes Agent 数据会保存到原生 Hermes 目录：

• Windows： %LOCALAPPDATA%hermes （找不到时回退到 %APPDATA%hermes ）
• macOS/Linux： ~/.hermes

桌面壳自身的 Web UI 状态会单独保存到 ~/.hermes-web-ui ，除非设置了 HERMES_WEB_UI_HOME 。

打包后的桌面应用启动后，会安装受管命令 shim，避免桌面应用、内置 Hermes Agent CLI 和内置 Web UI CLI 的命令互相冲突：

使用 hermes-studio cli -h 查看 Hermes Agent CLI 帮助，使用 hermes-studio web -h 查看 Web UI CLI 帮助。

桌面自动更新会优先读取 https://download.ekkolearnai.com/latest 。 如果该端点不可用，更新器会回退到 https://github.com/EKKOLearnAI/hermes-studio/releases/latest/download 。

npm 安装 #

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

打开 http://localhost:8648

Docker Compose #

单容器部署，内置 Hermes Agent 运行时：

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

# 或从源码构建
docker compose up -d --build

docker compose logs -f hermes-webui

打开 http://localhost:6060

• Hermes 持久化数据目录：./hermes_data
• Web UI 认证 Token 存储在 ./hermes_data/hermes-web-ui/.token
• 首次启动并开启认证时，Token 会打印到容器日志中
• 运行参数全部由 docker-compose.yml 环境变量驱动

更详细的说明与排错见： docs/docker.md

Hermes Agent 运行时发现 #

Web UI 启动后端聊天能力时，会优先使用包含 run_agent.py 的源码目录，例如 ~/.hermes/hermes-agent 。如果找不到源码目录，会退回到已安装 hermes 命令所使用 的 Python 环境，再退到系统 Python。因此源码安装和 pip install hermes-agent 这类 包安装方式都可以兼容。

Web UI 环境变量 #

这些变量用于配置 Hermes Web UI、本地 Hermes runtime 集成以及开发/预览辅助能力。Provider API Key 和 Hermes Agent 相关设置通常仍通过 Hermes profile 管理；这里列出的变量是进程级覆盖项。

CLI 命令 #

restart 、 update 和 upgrade 默认会停止 Agent Bridge broker，避免重启或更新后的服务复用旧 Python bridge 进程。只有明确希望保留 broker 和正在运行的 bridge session 时，才在重启前设置 HERMES_AGENT_BRIDGE_STOP_ON_SHUTDOWN=0 。

update / upgrade 会先尝试执行 npm cache clean --force ，再执行 npm install -g hermes-web-ui@latest 并重启。缓存清理是 best-effort；如果清理失败，只提示 warning，升级安装会继续执行。

自动配置 #

启动时 BFF 服务器会自动：

• 初始化 Web UI 数据目录、本地数据库和内置技能
• 启动 /chat-run 使用的 Hermes agent bridge
• 启动成功后自动打开浏览器

开发 #

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

• 前端： http://localhost:8649
• BFF 服务器： http://localhost:8647

  npm run build   # 构建输出到 dist/

项目开发规范见： DEVELOPMENT.md 。

架构 #

浏览器 → BFF (Koa, :8648) → Socket.IO /chat-run
                ↓
        Hermes agent bridge → Hermes Agent runtime
                ↓
           Hermes CLI / profiles
           profile config.yaml    (渠道/Provider 配置)
           profile auth.json      (凭证池)
           腾讯 iLink API         (微信扫码登录)

前端采用 多 Agent 可扩展架构 — 所有 Hermes 相关代码都按命名空间组织在 hermes/ 目录下（API、组件、视图、Store），可以方便地并行接入新的 Agent。

BFF 层负责：Socket.IO 聊天流式推送、Hermes agent bridge、按 Profile 隔离的上传和按路径解析的下载（多 Backend 支持：local/Docker/SSH/Singularity）、会话 CRUD、分账户分 Profile 管理、配置/凭证管理、微信扫码登录、模型发现、技能/记忆/插件管理、TTS/STT、Coding Agent 代理、MCP/Runtime 管理、日志读取和静态文件服务。

技术栈 #

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

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

许可证 #

BSL-1.1

该许可证覆盖 Hermes Studio、原 Hermes Web UI 名称、 hermes-web-ui npm 包和 CLI、桌面应用、固件、发布产物、文档以及本仓库内的关联文件。