搜尋文件...

開始輸入以搜尋文件

Hermes Agent
Hermes Agent

Hermes Agent 整合

將 UnoRouter 用作 Hermes Agent 的模型提供方。將一個 OpenAI 相容端點指向 UnoRouter,即可存取所有模型。

概覽

Nous Research 的 Hermes Agent 是一個自我改進的 AI 代理,可作為 CLI、TUI、訊息閘道或 IDE 整合執行,並具備持久的磁碟記憶。將其供應商設為 custom,並把基礎 URL 指向 UnoRouter,即可透過一個服務所有模型的 OpenAI 相容端點路由每一輪對話。

快速設定

將這些值填入用戶端。登入後會自動填入你的金鑰。

text
基礎 URL: https://api.unorouter.com/v1
API 金鑰: YOUR_API_KEY

登入以自動填入 API 金鑰

相容性

Chat Completions串流工具呼叫

逐步設定

  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 並開始工作。

powershell
# 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

登入以自動填入 API 金鑰

推薦模型

在這裡表現良好的免費模型。把任意模型 ID 貼到用戶端即可。

gpt-oss-20bcompoundgemini-3.1-pro-previewmistral-medium-3deepseek-v3.2

注意事項

  • Hermes 在啟動時會拒絕上下文低於 64,000 個 token 的模型。請從 UnoRouter 模型頁面選擇上下文更大的模型。
  • 如果啟動時的 `/v1/models` 檢查失敗,請確認 `model.base_url` 以 `/v1` 結尾,且 `OPENAI_API_KEY` 已在 `~/.hermes/.env` 中設定。
產生 API 金鑰模型