Hermes Agent 集成

概览

Nous Research 的 Hermes Agent 是一个自我改进的 AI 代理，可作为 CLI、TUI、消息网关或 IDE 集成运行，并具备持久的磁盘记忆。将其提供方设为 custom，并把基础 URL 指向 UnoRouter，即可通过一个服务所有模型的 OpenAI 兼容端点路由每一轮对话。

快速配置

将这些值填入客户端。登录后会自动填入你的密钥。

基础 URL: https://api.unorouter.com/v1
API 密钥: YOUR_API_KEY

兼容性

逐步设置

1. 1
   安装 Hermes

   运行安装脚本来设置 Hermes Agent。在 Windows 上，请在 WSL2 内安装。

   bash

   curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

   登录以自动填入您的 API 密钥

2. 2
   将提供商指向 UnoRouter

   编辑 `~/.hermes/config.yaml`，将 `model.provider` 设为 `custom`，并将 `model.base_url` 设为 UnoRouter 的基础 URL。请选择上下文至少为 64k 的默认模型。

   yaml

   # ~/.hermes/config.yaml
   model:
     provider: "custom"
     base_url: "https://api.unorouter.com/v1"
     default: "YOUR_MODEL_ID"

   登录以自动填入您的 API 密钥

3. 3
   添加 API 密钥

   将你的 UnoRouter API 密钥以 `OPENAI_API_KEY` 形式存入 `~/.hermes/.env`，使 Hermes 在每一轮都进行认证。

   bash

   # ~/.hermes/.env
   OPENAI_API_KEY=YOUR_API_KEY

   登录以自动填入您的 API 密钥

4. 4
   运行 Hermes

   使用 `hermes --tui` 启动 TUI 并开始工作。

   bash

   hermes --tui

   登录以自动填入您的 API 密钥

# Hermes runs under WSL2 on Windows.
# In ~/.hermes/config.yaml set model.provider: "custom"
# and model.base_url: "https://api.unorouter.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

hermes --tui

推荐模型

在这里表现良好的免费模型。把任意模型 ID 粘贴到客户端即可。

注意事项

• !Hermes 在启动时会拒绝上下文低于 64,000 个 token 的模型。请从 UnoRouter 模型页面选择上下文更大的模型。
• !如果启动时的 `/v1/models` 检查失败，请确认 `model.base_url` 以 `/v1` 结尾，且 `OPENAI_API_KEY` 已在 `~/.hermes/.env` 中设置。