Hermes Agent 配置チュートリアル
Hermes Agent のモデル、ベンダー、およびカスタムエンドポイントは ~/.hermes/config.yaml に保存されます。API Key などの機密情報は ~/.hermes/.env に保存されます。ai2save は OpenAI Compatible インターフェースを使用し、Base URL は https://ai2save.com/v1 です。
1. API Key を作成する
- https://ai2save.com/keys を開きます。
- キーを作成し、ターゲットモデルを含むグループを選択します。
- 完全な
sk-...キーをコピーします。 - コンソールに表示される実際のモデルIDを記録します(例:
gpt-5.5)。
2. 組み込みウィザードの使用を推奨
ターミナルで実行:
hermes model
指示に従って選択してください:
Custom endpoint (self-hosted / vLLM / etc.)
順に入力してください:
API base URL: https://ai2save.com/v1
API key: sk-あなたのAPIキー
Model name: gpt-5.5
ガイドはこれらの値を ~/.hermes/config.yaml に書き込みます。Base URL を .env に書き込まないでください。Hermes 公式のモデルエンドポイント設定は config.yaml から取得することが規定されています。
3. 手動で設定ファイルを編集する
~/.hermes/config.yaml を編集してください:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
フィールドの説明:
provider: custom:任意の OpenAI Compatible エンドポイントを使用します。default:デフォルトのモデル ID、コンソールで公開されているモデル ID と完全に一致する必要があります。base_url:/v1を添付する必要があります。Hermes はこれを基に/chat/completionsをリクエストします。key_env:キーを保存する環境変数の名前を指します。
~/.hermes/.env を編集:
AI2SAVE_API_KEY=sk-あなたのAPIキー
.env は機密情報を保存し、config.yaml は非機密のモデル構成を保存します。.env を Git に提出しないでください。
4. 設定コマンドを使用して書き込む
Hermes に付属のコマンドを使用することもでき、YAML のインデントエラーを避けられます:
hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-あなたのAPIキー
hermes config check
AI2SAVE_API_KEY は大文字環境変数名で、Hermes は自動的に ~/.hermes/.env を書き込みます。
5. 再起動と確認
- 現在の Hermes セッションまたは Gateway から完全に終了します。
- Hermes を再起動します。
- 新しいセッションを作成し、短い質問を送信します。
- セッション内で
/modelを入力し、現在のモデルがcustom/gpt-5.5またはgpt-5.5であることを確認します。
一時的に指定モデルを使用する場合:
hermes chat --provider custom --model gpt-5.5
初回の検証では、並列タスクや複雑なツールはオフにし、短いテキストのみを送信することを推奨します。認証とモデル接続が確認できたら、順次 terminal、web、file などのツールを有効にしてください。
6. よくあるエラー
- 401 / invalid_api_key:
AI2SAVE_API_KEYが存在しないか、値が不完全です。hermes config get model.key_envを実行して参照を確認してください。 - 404 / model not found:
model.defaultはコンソールで公開されている実際のモデルIDではありません。 - 接続失敗:
base_urlはhttps://ai2save.com/v1であるべきです;https://ai2save.comと書かないでください。 - 設定が反映されない:旧
OPENAI_BASE_URLはopenai-apiProvider のみに影響し、自動的にcustomには適用されません;config.yaml内のmodel.base_urlを確認してください。 - YAML の解析失敗:重複する
model:ブロックを作らず、すべてのフィールドを同じブロックにまとめてください。 - ツール呼び出し例外:まずモデルが tool calling をサポートしていることを確認し、短いテキストでリクエストしてベースラインを作成してからツールセットを有効にしてください。