# Hermes-dashboard

**Repository Path**: sylh/hermes-dashboard

## Basic Information

- **Project Name**: Hermes-dashboard
- **Description**: Hermes 中文仪表盘（Hermes Dashboard）是一套面向 Hermes Agent 的轻量级中文可视化管理面板。它将网关连接、模型对话、技能工具浏览与系统监控统一收敛到一个简洁的中文界面中，让不熟悉英文界面的团队也能快速上手、部署与运维 Hermes。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hermes-bashboard 仪表盘

> 一个**零外部依赖**、单文件前端 + Python 代理的 Hermes Agent 中文控制台。
> 由「思源领航」团队维护。

## 简介

[Hermes](https://github.com/hermes-engineering/hermes) 是一个开源的企业级 AI Agent 网关平台，把大语言模型包装成具备工具调用能力的智能体。原版官方 Dashboard 是英文界面，且在跨机访问时容易出现资源加载失败、样式缺失等问题。

本仪表盘是一套**Hermes控制台**：

- 前端为**单文件 HTML + 内联 CSS/JS**，零 CDN、零构建，根治跨机样式丢失；
- 后端为**一个 Python 文件**，仅用标准库，内置极简 YAML 解析器，**无需任何第三方依赖**；
- 通过本地代理转发 Hermes 网关与模型 API，自动注入网关鉴权与模型 Key，**前端不再接触任何账号密码**；
- 自带独立的**门户登录**，与工作无关的访客无法访问；
- 全中文化：配置字段、技能、工具集均自动翻译（CAT / TERM / TOOLSET_ZH 翻译层）。

## 特性

- ✅ 全中文界面，配置 / 技能 / 工具自动翻译
- ✅ 七大模块：概览 / 对话 / 配置 / 技能与工具 / 定时任务 / 会话历史 / 关于
- ✅ 技能与工具集在线添加、启停
- ✅ 会话历史多级滚动，长对话不丢上下文
- ✅ 一键重启网关（带二次确认）
- ✅ 独立门户登录 + HttpOnly Cookie 会话
- ✅ 服务端代理自动注入网关 / 模型凭据，前端零敏感信息
- ✅ 左侧导航底部内置「思源领航」公众号引流卡片

## 架构

```
浏览器 (中文仪表盘)
   │  仅携带 dash_sid Cookie
   ▼
本地代理 (app.py :9090)  ◀── config.yml（端口 / 网关 / 模型 / 账号密码 / 公众号）
   │  自动注入 Hermes 网关 Basic Auth + 模型 Bearer Key
   ├──► Hermes 网关   :9119   (/api/*)
   └──► 模型 API       :8642   (/v1/chat/completions)
```

三层凭据隔离（都**只存在于服务端**，绝不下发到浏览器）：

1. **仪表盘门户登录**：`config.yml` 的 `auth` 段，独立于 Hermes，仅控制谁能打开本台；
2. **Hermes 网关账号**：`config.yml` 的 `hermes.default_user / default_pass`，服务端代理登录用；
3. **模型 API Key**：`config.yml` 的 `hermes.default_model_key`，服务端注入对话请求。

## 快速开始

```bash
# 1. 准备配置
cp config.example.yml config.yml
#    编辑 config.yml，填入你的 Hermes 网关地址、账号密码与模型 Key

# 2. 启动（需 Python 3.8+，无需 pip install）
python app.py

# 3. 浏览器访问
#    http://127.0.0.1:9090
#    用 config.yml 中 auth 段的账号密码登录
```

## 配置说明（config.yml）

| 段 | 字段 | 说明 |
|----|------|------|
| `server`  | `port` / `bind` | 仪表盘监听端口与绑定地址 |
| `auth`    | `enabled` / `username` / `password` | 仪表盘门户登录账号（**与 Hermes 无关**） |
| `hermes`  | `gateway_url` | Hermes 网关地址（端口 9119） |
| `hermes`  | `model_url` | 模型 API 地址（端口 8642） |
| `hermes`  | `default_user` / `default_pass` | 网关账号密码，服务端代理登录用 |
| `hermes`  | `default_model_key` | 模型 API Key，服务端注入对话 |
| `defaults`| `title` / `subtitle` / `footer` / `sys_prompt` | 前端文案与系统提示词 |
| `promo`   | `name` / `description` / `qrcode_path` | 侧边栏公众号引流（思源领航） |

> `config.yml` 含敏感凭据，**请勿提交到代码仓库**；仓库中仅保留 `config.example.yml`。

## 目录结构

```
hermes-dashboard/
├── app.py              # 零依赖代理 + 静态服务 + 登录鉴权
├── config.yml          # 你的配置（不入库，参考 config.example.yml）
├── config.example.yml  # 配置模板
├── index.html          # 前端（已混淆，发布版）
├── static/
│   └── qrcode.jpg      # 公众号二维码
├── requirements.txt    # 依赖清单（无第三方依赖）
└── README.md
```

## 运行界面

![输入图片说明](static/image-20260814105607960.png)

![输入图片说明](static/image-20260814105732603.png)

![输入图片说明](static/image-20260814105818485.png)

## 安全说明

- 仪表盘登录为独立门户，与 Hermes 网关账号完全解耦；
- 所有网关账号密码 / 模型 Key 仅存于服务端 `config.yml` 与内存，前端经代理访问，绝不接触明文凭据；
- 未登录访问任何代理接口 `/gateway/*`、`/model/*`、`/api/server-config` 均返回 401；
- 建议在生产环境前置 HTTPS / 反向代理，并务必修改默认 `auth` 密码。

## 关于「思源领航」公众号

关注「**思源领航**」公众号，获取 AI Agent 最新实践、技术干货与开源资讯。我们持续分享大模型应用落地经验、企业级 AI 助手搭建指南，以及 Hermes 生态的深度解读。

<div align="center">
  <img src="static/qrcode.jpg" width="180" alt="思源领航公众号二维码"/>
  <p>微信扫一扫，关注「思源领航」</p>
</div>

## 许可

本仪表盘以 MIT 协议开源。Hermes Agent 本身的许可请遵循其上游仓库。