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。