Hermes Agent連携
Hermes Agent のモデルプロバイダーとして UnoRouter を使用します。OpenAI互換エンドポイントを UnoRouter に向けるだけで、すべてのモデルにアクセスできます。
Nous Research の Hermes Agent は、自己改善するオープンソースの AI エージェントです。ターミナル、メッセージングゲートウェイ、IDE 連携として動作し、ディスク上に永続的なメモリを保持し、あらゆる OpenAI互換エンドポイントで動作します。
主な機能
- 自己改善 - 経験からスキルを構築し、セッションをまたいであなたの好みのモデルを永続的に保持します。
- OpenAI互換 - 各チャットのやり取りをカスタムエンドポイント経由でルーティングし、UnoRouter がすべてのモデルを提供します。
- 複数のインターフェース - 従来の CLI、最新の TUI、メッセージングゲートウェイ、ACP 経由の IDE 連携を、すべて単一のコアで提供します。
- ゲートウェイとプロキシ - OpenAI互換の API サーバーと、OAuth 対応プロバイダー向けのローカルサブスクリプションプロキシを公開します。
インストール
スクリプトまたは PyPI 経由でインストールします。postinstall ステップでオプションのツールを取得し、セットアップウィザードを実行します。
# 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 では Hermes Agent は WSL2 上で動作します。WSL2 ディストリビューション内でインストールおよび設定してください。設定は ~/.hermes/config.yaml にあります。
設定
~/.hermes/config.yaml を編集して Hermes を UnoRouter 経由にルーティングします。provider を custom にすると base_url が優先され、すべてのやり取りが UnoRouter に送られます。
~/.hermes/config.yaml
model:
provider: "custom"
base_url: "https://api.unorouter.ai/v1"
default: "claude-opus-4-8"API キーは ~/.hermes/.env に保存します（またはシェルで設定します）。Hermes はカスタムエンドポイントに OPENAI_API_KEY を使用します。
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 から読み込まれます。 |
Hermes は少なくとも 64,000 トークンのコンテキストを持つモデルを必要とします。多段のツール利用には作業メモリが必要なため、小さいウィンドウは起動時に拒否されます。
CLI での代替方法
ファイル編集よりコマンドが好みですか。Hermes は各値を自動的に正しいファイルへ書き込みます。
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_KEYHermes を実行
セッションを開始し、いつでもモデルやプロバイダーを切り替え、設定を診断できます。
# Interactive TUI (recommended)
hermes --tui
# Switch model or provider any time
hermes model
# Diagnose configuration
hermes doctor始める準備はできましたか
API キーを取得して、UnoRouter を Hermes Agent で使い始めましょう。