企业官网建设流程全解析

Hermes WebUI 多模型管理指南：4 步接入任意 AI 模型，随时切换

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui

Hermes WebUI 是 Hermes Agent 的网页界面，让你在手机或电脑浏览器里使用同一个 Agent。它的模型管理部分允许你在一个界面里接入 OpenAI、Anthropic、Google、DeepSeek、OpenRouter，以及本地跑的 Ollama、LM Studio。适合已经在用 Hermes Agent、想把多个模型提供商集中管理、并随时按任务切换模型的人。

🚀 4 步完成首次接入

1. 克隆仓库并运行引导脚本：

git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui python3 bootstrap.py

2. 脚本会自动检测 Hermes Agent、建好 Python 环境，等/health通过后打开浏览器，进入首次设置向导。
3. 在向导里选一个提供商。按所需信息，向导把它们分成三组：OpenRouter、Anthropic、OpenAI 只需 API 密钥和模型；Ollama、LM Studio 这类自托管服务填 Base URL（可免密钥）；Gemini、DeepSeek 等填专用密钥。
4. 点 Test connection，向导会去探测<base-url>/models，成功后自动填好模型下拉列表，完成保存。

密钥写入 Hermes 的.env，默认模型写入config.yaml，之后不需要再碰配置文件。

🏠 本地模型接入：1 个 URL 定生死

适用场景：模型跑在本地或内网，不想用云 API。

关键只有一个：Base URL 必须指向 OpenAI 兼容的 API 根路径。本机直接跑的服务：

LM Studio http://127.0.0.1:1234/v1 Ollama http://127.0.0.1:11434/v1

注意点：在 Docker 里跑 WebUI 时，localhost指的是容器自己，不是宿主机。Docker Desktop 下改成http://host.docker.internal:1234/v1；Linux 下建议用 LAN IP，或在 Compose 里加extra_hosts: api.local:host-gateway别名。完整的 URL 对照表在 onboarding 文档里。

💬 会话中途换模型：上下文不丢

适用场景：长对话里临时想换个模型继续聊，比如从便宜模型换到强模型处理关键段落。

• 打开输入框底部的模型选择器，选新模型，下一条消息即用新模型，之前的对话内容原样保留。
• 也可以直接用/model <name>命令切换。
• 若当前模型不可用，系统会按配置回退到备用模型，界面会提示实际用的哪个。

注意：切换模型不会重置上下文用量，但不同模型的上下文窗口大小不同，输入框底部的 token 圆环会按当前模型重新计算。

🗂️ 用 Profile 隔离两套模型配置

适用场景：工作项目用公司密钥，个人项目用本地 Ollama，不想来回改配置。

1. 在侧边栏的 Profile 面板新建一个 Profile，创建时可直接填 Base URL 和 API Key，写入该 Profile 独立的config.yaml。
2. 通过输入框底部的 Profile 芯片切换，无需重启服务，配置、技能、记忆、模型列表全部热加载。
3. 每个会话记录它创建时用的 Profile，侧边栏可筛选查看。

注意：切换 Profile 时若有正在运行的会话，界面会提示，避免运行中的任务被新配置打断。

📊 用 Insights 面板核对 token 花费

适用场景：用了几天后，想知道哪个模型花得最多、响应是否正常。

打开 Insights 面板，按日期查看各模型的 token 消耗曲线；System 视图看服务可用性、延迟和错误率。结合 故障排查文档 可以定位是网络问题还是模型本身的问题。

❓ 模型列表为空的自查

测试连接报错、下拉列表是空的？多半是 Base URL 多写或少写了/v1。向导探测的是<base-url>/models，端点形状不对就会显示 DNS、拒绝连接或 HTTP 错误，按提示的报错类型逐项查。

Docker 里连不上宿主机 Ollama/LM Studio？localhost解析到了容器回环。换成host.docker.internal（Docker Desktop）或 LAN IP。

换了提供商后列表还是旧的？模型列表有缓存，到 Settings → Providers 点刷新，让它重新拉取/models端点。

向导提示改用hermes model命令？部分高级提供商（如 Nous Portal）目前仍是终端优先流程，先按向导提示在终端完成，再刷新 WebUI 即可，不是故障。

✅ 上手指引清单

• 向导里对每个提供商都点过 Test connection
• 本地服务的 Base URL 以/v1结尾，Docker 场景已避开localhost
• 至少配置一个备用模型，主模型不可用时能自动回退
• 工作/个人配置已拆成两个 Profile，各自独立密钥
• 输入框底部圆环的 token 用量养成每天看一眼的习惯
• 长会话结束前用/usage查看本会话开销
• 关键会话导出为 Markdown 或 JSON 备份

Hermes WebUI 的价值，是把"多模型提供商管理"收敛进一个浏览器界面：接入、切换、隔离、核对花费，全程不用改配置文件。现在就可以打开向导，把第一个备用模型接上——多一个模型，就少一分被单一提供商卡住的风险。

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui