Skip to main content
CometAPI を Hermes Agent のモデルプロバイダーとして使用します。このガイドでは、Hermes が CometAPI に接続するための 2 つの経路をサポートします。ほとんどのテキストモデル向けの一般的な OpenAI 互換エンドポイントと、Anthropic メッセージ経由の Claude ルートです。

​
前提条件

  • Git
  • 有効な API キーを持つ CometAPI アカウント
  • macOS、Linux、または WSL2 のターミナル

​
インストール

1

CometAPI API キーを取得する

CometAPI コンソール にログインします。Add API Key をクリックし、CometAPI API キーをコピーします。
Add API Key ボタンが表示された CometAPI ダッシュボード
base URL が表示された CometAPI API キーの詳細
2

Hermes Agent をインストールする

次のコマンドは公式インストーラーを実行します。
現在のシェルでまだ hermes コマンドを認識しない場合は、シェル設定を再読み込みします。
Hermes は設定を ~/.hermes/ に保存し、hermes コマンドを ~/.local/bin にリンクし、必要に応じて ~/.local/bin をシェルの PATH に追加することがあります。

​
設定

モデルファミリーに一致する CometAPI のルートを選択してください。
Hermes を https://api.cometapi.com/v1beta でカスタムの Gemini ネイティブ provider として設定しないでください。Gemini モデルには OpenAI 互換の Hermes 設定を使用してください。Gemini API を直接呼び出す場合は、Gemini generateContent API を使用してください。
1

CometAPI キーを保存する

~/.hermes/.env を開き、以下の値を追加します:
COMETAPI_KEY は名前付きの Claude provider で使用されます。OPENAI_API_KEY は、Hermes のカスタム OpenAI 互換エンドポイントのフォールバックを機能させるために使用されます。
2

OpenAI 互換ルートを設定する

このルートは、Hermes から使用する Gemini モデルを含む、ほとんどの CometAPI テキストモデルで使用します。~/.hermes/config.yaml を開き、model セクションが次のようになっていることを確認してください:
your-model-id を、CometAPI Models page にある現在のテキスト model ID に置き換えてください。
API キーは ~/.hermes/.env に保持してください。config.yaml にシークレットをハードコードしないでください。
この設定はメインのチャットモデルを構成します。Hermes は、vision や web extraction などのタスクのために、個別の補助モデルを使用できます。
3

Claude Messages ルートを設定する

Hermes から Anthropic Messages 経由で Claude モデルを呼び出したい場合は、このルートを使用します。~/.hermes/config.yaml を開き、名前付き provider を使用してください:
your-claude-model-id を、CometAPI Models page にある現在の Claude model ID に置き換えてください。
このルートでは base_url を https://api.cometapi.com のままにしてください。Hermes は名前付き provider から Anthropic Messages transport を使用します。

​
検証

1

設定を確認する

次のコマンドで、Hermes が設定と API キーを読み取れることを確認できます:
更新後に hermes config check で不足しているオプションが報告された場合は、hermes config migrate を実行してから、もう一度確認してください。
2

実際のチャットテストを実行する

次のコマンドは、CometAPI 経由で実際のリクエストを送信します:
設定が成功していれば、CONNECTED が返され、auth または endpoint のエラーは発生しません。Claude Messages の設定が有効な場合、これにより Hermes が CometAPI 経由で anthropic_messages transport を使用できることも確認できます。

​
オプション設定

以前の Hermes インストールを置き換える場合は、まず組み込みのアンインストーラーを使用してください。
アンインストーラーでは、CLI、PATH エントリ、~/.hermes/ のデータを削除するために Full uninstall を選択します。その後、インストール手順を再実行し、同じ CometAPI 設定のまま続行してください。
OpenAI 互換ルートで対話型フローを使いたい場合は、hermes model を実行して Custom endpoint を選択してください。次に、以下の値を入力します。
  • Base URL: https://api.cometapi.com/v1
  • API key: あなたの CometAPI API key
  • Model: 現在の CometAPI テキスト model ID
このフローでは、OpenAI 互換のプロバイダー設定が config.yaml に書き込まれます。Claude Messages を使う場合は、名前付きプロバイダーが transport: anthropic_messages を維持するように、config.yaml を直接編集してください。