跳轉到主要內容
透過 Hermes 對自訂 OpenAI 相容端點的支援，使用 CometAPI 作為 Hermes Agent 的模型提供者。

​
先決條件

  • Git
  • 具有啟用中 API key 的 CometAPI 帳戶
  • macOS、Linux 或 WSL2 上的終端機

​
安裝

1

取得你的 CometAPI API key

登入 CometAPI 主控台。按一下 Add API Key，並複製你的 <COMETAPI_KEY> 金鑰。
顯示 Add API Key 按鈕的 CometAPI 儀表板
顯示 base URL 的 CometAPI API key 詳細資訊
2

安裝 Hermes Agent

以下指令會執行官方安裝程式：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
如果目前 shell 尚未識別 hermes 指令，請重新載入 shell 設定：
source ~/.zshrc
# or
source ~/.bashrc
Hermes 會將設定儲存在 ~/.hermes/、將 hermes 指令連結到 ~/.local/bin，並且可能會將 ~/.local/bin 加入你的 shell PATH。

​
設定

1

儲存你的 CometAPI key

開啟 ~/.hermes/.env 並加入以下這一行：
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes 會將 OPENAI_API_KEY 作為自訂 OpenAI 相容端點的驗證備援。
2

設定 CometAPI 端點

開啟 ~/.hermes/config.yaml，並確認 model 區段如下所示：
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
將 your-model-id 替換為 CometAPI Models 頁面 上目前可用的文字 model ID。
請將 API key 保留在 ~/.hermes/.env 中。不要在 config.yaml 中硬編碼任何密鑰。
此設定會配置主要聊天模型。Hermes 也可以針對視覺或網頁擷取等任務使用不同的輔助模型。

​
驗證

1

檢查設定

以下指令可確認 Hermes 能夠讀取設定與 API key：
hermes config check
hermes doctor
hermes status
如果 hermes config check 在更新後回報缺少選項，請執行 hermes config migrate，然後再次檢查。
2

執行實際聊天測試

以下指令會透過 CometAPI 傳送實際請求：
hermes chat -q "Reply with the single word CONNECTED."
設定成功時會回傳 CONNECTED，且不會出現驗證或端點錯誤。

​
選用設定

如果你要取代舊版 Hermes 安裝，請先使用內建解除安裝程式：
hermes uninstall
在解除安裝程式中，選擇 Full uninstall 以移除 CLI、PATH 項目與 ~/.hermes/ 資料。接著重新執行安裝步驟，並繼續使用相同的 CometAPI 設定。
如果你偏好互動式流程，請執行 hermes model 並選擇 Custom endpoint。接著輸入以下值：
  • Base URL: https://api.cometapi.com/v1
  • API key: 你的 CometAPI API key
  • Model: 目前可用的 CometAPI 文字 model ID
此流程會將相同的 provider 設定寫入 config.yaml。