Hermes Agent
Hermes Agent 集成
将 UnoRouter 用作 Hermes Agent 的模型提供方。将一个 OpenAI 兼容端点指向 UnoRouter，即可访问所有模型。
什么是 Hermes Agent？
Nous Research 的 Hermes Agent 是一个开源、可自我改进的 AI 智能体。它可在终端、消息网关和 IDE 集成中运行，将持久记忆保存在磁盘上，并可与任何 OpenAI 兼容端点配合使用。
核心功能
- 自我改进 - 从经验中构建技能，并跨会话持续建立对你偏好的模型。
- OpenAI 兼容 - 将每一轮对话通过一个自定义端点路由，使 UnoRouter 提供所有模型。
- 多种界面 - 经典 CLI、现代 TUI、消息网关以及通过 ACP 的 IDE 集成，全部基于同一内核。
- 网关与代理 - 提供一个 OpenAI 兼容的 API 服务器，以及面向 OAuth 提供方的本地订阅代理。
安装
通过脚本或 PyPI 安装。postinstall 步骤会拉取可选工具并运行配置向导。
bash
# Install script (recommended)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# Or via PyPI
pip install hermes-agent
hermes postinstallWindows 需要 WSL2
在 Windows 上，Hermes Agent 在 WSL2 中运行。请在你的 WSL2 发行版中安装和配置，配置文件位于 ~/.hermes/config.yaml。
配置
编辑 ~/.hermes/config.yaml，使 Hermes 通过 UnoRouter 路由。当 provider 设为 custom 时，base_url 优先，每一轮都会发往 UnoRouter：
~/.hermes/config.yaml
yaml
model:
provider: "custom"
base_url: "https://api.unorouter.ai/v1"
default: "claude-opus-4-8"将 API 密钥保存在 ~/.hermes/.env 中（或在 shell 中设置）。对于自定义端点，Hermes 使用 OPENAI_API_KEY：
bash
OPENAI_API_KEY=YOUR_API_KEY关键配置项
| 字段 | 说明 |
|---|---|
| model.provider | 设为 custom，使 Hermes 直接调用你的端点，而非内置提供方。 |
| model.base_url | UnoRouter 的 OpenAI 兼容基础 URL。Hermes 在启动时会通过 /v1/models 进行校验。 |
| model.default | 默认模型 ID。在 models 列表中添加更多 ID 可填充模型选择器。 |
| OPENAI_API_KEY | 你在仪表盘获取的 UnoRouter API 密钥，从 ~/.hermes/.env 读取。 |
选择 64k 以上上下文的模型
Hermes 要求模型至少具有 64,000 个 token 的上下文。较小的上下文窗口会在启动时被拒绝，因为多步骤工具调用需要足够的工作记忆。
CLI 替代方式
比起编辑文件更喜欢命令？Hermes 会自动将每个值写入正确的文件：
bash
hermes config set model.provider custom
hermes config set model.base_url https://api.unorouter.ai/v1
hermes config set OPENAI_API_KEY YOUR_API_KEY运行 Hermes
开始一个会话，随时切换模型或提供方，或诊断你的配置：
bash
# Interactive TUI (recommended)
hermes --tui
# Switch model or provider any time
hermes model
# Diagnose configuration
hermes doctor准备好开始了吗？
获取你的 API 密钥，开始在 Hermes Agent 中使用 UnoRouter。