菜单
Complete setup guide for installing Hermes Agent (AI assistant) and Hermes UI (glassmorphic web interface), including API server configuration and troubleshooting.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tangzheng202202/hermes-skills --skill hermes-agent-ui-setup命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Integrate Darwin evaluation system with skill-manager for automated skill quality assessment and evolution using AI optimization
DevOps tools - Docker, cron jobs, webhooks, troubleshooting
GitHub workflows - repos, PRs, issues, code review
正在显示 SKILL.md
基于 SOC 职业分类
| name | hermes-agent-ui-setup |
| title | Setup Hermes Agent with Web UI |
| description | Complete setup guide for installing Hermes Agent (AI assistant) and Hermes UI (glassmorphic web interface), including API server configuration and troubleshooting. |
| tags | ["hermes","ai-agent","web-ui","self-hosted","api-server"] |
| triggers | ["install hermes agent","setup hermes ui","hermes web interface","hermes api server"] |
安装 Hermes Agent（AI 助手）和 Hermes UI（玻璃拟态 Web 界面）的完整流程。
方案 A：通过 pip 从 GitHub 安装（推荐）
# 创建专用目录
mkdir -p ~/hermes-agent && cd ~/hermes-agent
# 使用 Python 3.11+ 创建虚拟环境
python3.11 -m venv .venv
source .venv/bin/activate
# 从 GitHub 安装最新版
uv pip install "git+https://github.com/NousResearch/hermes-agent.git"
hermes --version
hermes doctor
方案 B：如果 git clone 被拦截，使用 curl 下载
mkdir -p ~/hermes-ui && cd ~/hermes-ui
# 下载核心文件（绕过 git 限制）
curl -sL -o serve.py "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/serve.py"
curl -sL -o hermes-ui.html "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/hermes-ui.html"
curl -sL -o requirements.txt "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/requirements.txt"
# 验证下载
ls -la
方案 C：使用 GitHub API 获取文件列表
如果批量下载多个文件：
# 获取仓库文件列表
python3 -c "
import urllib.request
import json
import base64
# 获取目录内容
url = 'https://api.github.com/repos/NousResearch/hermes-agent/contents/'
req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
with urllib.request.urlopen(req) as r:
data = json.loads(r.read().decode())
for f in data:
print(f['name'], f['type'])
"
# 获取特定文件内容（含 base64 解码）
python3 -c "
import urllib.request
import json
import base64
url = 'https://api.github.com/repos/NousResearch/hermes-agent/contents/pyproject.toml'
req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
with urllib.request.urlopen(req) as r:
data = json.loads(r.read().decode())
content = base64.b64decode(data['content']).decode('utf-8')
print(content)
"
mkdir -p ~/hermes-ui && cd ~/hermes-ui
# 下载核心文件（git clone 被拦截时使用此方法）
curl -sL -o serve.py "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/serve.py"
curl -sL -o hermes-ui.html "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/hermes-ui.html"
curl -sL -o requirements.txt "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/requirements.txt"
# 启动 UI 服务器（Python 标准库，零依赖）
python3 serve.py
# 或指定端口：python3 serve.py 8080
Hermes UI 需要连接到 Hermes Agent 的 API Server（默认端口 8642）。
编辑 ~/.hermes/config.yaml，添加以下配置：
# 1. 在 platform_toolsets 部分添加 api_server
platform_toolsets:
cli:
- browser
- terminal
# ... 其他工具
telegram:
- browser
# ...
api_server: # ← 添加这整个块
- browser
- clarify
- code_execution
- cronjob
- delegation
- file
- image_gen
- memory
- session_search
- skills
- terminal
- todo
- tts
- vision
- web
# 2. 在文件末尾添加 platforms 配置
platforms:
api_server:
enabled: true
host: 127.0.0.1
port: 8642
启动 Hermes Gateway（包含 API Server）：
hermes gateway start
# 或重启：hermes gateway restart
验证 API Server 是否运行：
lsof -i :8642
curl http://127.0.0.1:8642/health
# 应返回：{"status": "ok", "platform": "hermes-agent"}
启动 Hermes UI（另一个终端）：
cd ~/hermes-ui
python3 serve.py
打开浏览器访问：
http://localhost:3333/hermes-ui.html
原因： API Server 未启用或配置不正确
解决：
platforms.api_server.enabled: trueplatform_toolsets 中有 api_server: 配置hermes gateway restarttail -50 ~/.hermes/logs/gateway.log原因： Hermes UI 默认连接 localhost:8642
解决：
HERMES 变量指向正确的地址错误： "requires-python: >=3.11"
解决：
# 检查可用 Python 版本
ls -la ~/.local/bin/python* # uv 安装的 Python
ls -la /usr/local/bin/python* # Homebrew 安装的 Python
# 使用正确的版本创建 venv
python3.11 -m venv .venv
原因： Hermes Agent 不在 PyPI 上
解决： 使用 git+https 方式安装：
pip install "git+https://github.com/NousResearch/hermes-agent.git"
原因： 之前的 Hermes UI 进程未正确终止
解决：
# 查找并终止占用进程
lsof -i :3333
kill <PID>
# 或强制终止所有 Python 进程
pkill -f "serve.py"
原因： 环境变量未正确设置
解决：
.env 文件中有 FEISHU_APP_ID 和 FEISHU_APP_SECRETtail ~/.hermes/logs/gateway.log | grep -i feishu.env 文件被系统保护，使用 Python 脚本写入（见上文方法 B）# 查看状态
launchctl list | grep hermes
# 手动控制
launchctl stop ai.hermes.gateway
launchctl start ai.hermes.gateway
创建 LaunchAgent 文件：
cat > ~/Library/LaunchAgents/ai.hermes.ui.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>ai.hermes.ui</string>
<key>ProgramArguments</key>
<array>
<string>/usr/bin/python3</string>
<string>/Users/mac/hermes-ui/serve.py</string>
<string>3333</string>
</array>
<key>WorkingDirectory</key>
<string>/Users/mac/hermes-ui</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<dict>
<key>SuccessfulExit</key>
<false/>
</dict>
<key>StandardOutPath</key>
<string>/Users/mac/.hermes/logs/ui.log</string>
<key>StandardErrorPath</key>
<string>/Users/mac/.hermes/logs/ui.error.log</string>
</dict>
</plist>
EOF
# 加载并启动
launchctl load ~/Library/LaunchAgents/ai.hermes.ui.plist
launchctl start ai.hermes.ui
cd ~/.hermes/hermes-agent
source venv/bin/activate
uv pip install "lark-oapi>=1.5.3,<2" aiohttp websockets
im:message:send (发送消息)im:message.group_msg (接收群消息)im:message.p2p_msg (接收单聊)编辑 ~/.hermes/config.yaml：
platform_toolsets:
# ... 其他平台
feishu:
- browser
- clarify
- code_execution
- cronjob
- delegation
- file
- image_gen
- memory
- session_search
- skills
- terminal
- todo
- tts
- vision
- web
platforms:
feishu:
enabled: true
app_id: cli_xxxxxxxxxxxxxxxx
app_secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
domain: feishu # 或 lark（国际版）
connection_mode: websocket
⚠️ 注意：即使配置了 config.yaml，Feishu 插件仍需要从环境变量读取凭证。
方法 A：直接编辑 .env 文件（可能被系统保护）
echo 'FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx' >> ~/.hermes/.env
echo 'FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.hermes/.env
echo 'FEISHU_DOMAIN=feishu' >> ~/.hermes/.env
echo 'FEISHU_CONNECTION_MODE=websocket' >> ~/.hermes/.env
方法 B：使用 Python 写入（如果被拦截）
feishu_config = """
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_DOMAIN=feishu
FEISHU_CONNECTION_MODE=websocket
FEISHU_GROUP_POLICY=allowlist
"""
with open('/Users/mac/.hermes/.env', 'a') as f:
f.write(feishu_config)
方法 C：通过 export 设置（仅当前会话有效）
export FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export FEISHU_DOMAIN=feishu
export FEISHU_CONNECTION_MODE=websocket
launchctl stop ai.hermes.gateway
launchctl start ai.hermes.gateway
# 验证
lsof -i :8642
tail -f ~/.hermes/logs/gateway.log
# 应看到："[Feishu] Connected in websocket mode"
首次使用时，用户会收到配对码：
Hi~ I don't recognize you yet!
Here's your pairing code: 3HYG46F3
Ask the bot owner to run:
hermes pairing approve feishu 3HYG46F3
Bot 管理员执行授权：
cd ~/.hermes/hermes-agent
source venv/bin/activate
hermes pairing approve feishu 3HYG46F3
授权成功后用户即可正常使用。
~/hermes-agent/ # Hermes Agent 安装目录
├── .venv/ # 虚拟环境
└── ...
~/hermes-ui/ # Hermes UI 目录
├── serve.py # Python 代理服务器
├── hermes-ui.html # 前端单文件
└── requirements.txt # 依赖说明（零依赖）
~/.hermes/ # Hermes 配置和数据
├── config.yaml # 主配置文件
├── logs/ # 日志文件
├── sessions/ # 会话历史
└── hermes-agent/ # 源码安装位置（旧版）
更新 Hermes Agent：
cd ~/hermes-agent
source .venv/bin/activate
uv pip install --upgrade "git+https://github.com/NousResearch/hermes-agent.git"
更新 Hermes UI：
cd ~/hermes-ui
curl -sL -o hermes-ui.html "https://raw.githubusercontent.com/pyrate-llama/hermes-ui/main/hermes-ui.html"
# 重新下载更新的文件
serve.py 设计用于本地开发，不要暴露到公网/terminal/exec 端点允许执行任意 shell 命令