> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CometAPI で Hermes Agent を使う

> このガイドでは、OpenAI 互換チャットまたは Anthropic メッセージ設定を通じて Hermes Agent を CometAPI に接続する方法を説明します。

[CometAPI](https://www.cometapi.com) を [Hermes Agent](https://hermes-agent.nousresearch.com/docs/) のモデルプロバイダーとして使用します。このガイドでは、Hermes が CometAPI に接続するための 2 つの経路をサポートします。ほとんどのテキストモデル向けの一般的な OpenAI 互換エンドポイントと、Anthropic メッセージ経由の Claude ルートです。

## 前提条件

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

## インストール

<Steps>
  <Step title="CometAPI API キーを取得する">
    [CometAPI コンソール](https://www.cometapi.com/console/token) にログインします。**Add API Key** をクリックし、CometAPI API キーをコピーします。

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key ボタンが表示された CometAPI ダッシュボード" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="base URL が表示された CometAPI API キーの詳細" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Hermes Agent をインストールする">
    次のコマンドは公式インストーラーを実行します。

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    現在のシェルでまだ `hermes` コマンドを認識しない場合は、シェル設定を再読み込みします。

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      Hermes は設定を `~/.hermes/` に保存し、`hermes` コマンドを `~/.local/bin` にリンクし、必要に応じて `~/.local/bin` をシェルの PATH に追加することがあります。
    </Note>
  </Step>
</Steps>

## 設定

モデルファミリーに一致する CometAPI のルートを選択してください。

| モデルファミリー             | Hermes の設定                                                                         | CometAPI ルート                |
| -------------------- | ---------------------------------------------------------------------------------- | --------------------------- |
| OpenAI 互換のテキストモデル    | `model.provider: custom` に `base_url: https://api.cometapi.com/v1` を設定             | `/v1/chat/completions`      |
| Claude モデル           | `transport: anthropic_messages` を使用する名前付き provider                                 | `/v1/messages`              |
| Hermes 内の Gemini モデル | OpenAI 互換の設定を使用                                                                    | `/v1/chat/completions`      |
| 直接的な Gemini API 呼び出し | Hermes の外で [Gemini `generateContent` API](/api/text/gemini-generating-content) を使用 | `/v1beta` `generateContent` |

<Warning>
  Hermes を `https://api.cometapi.com/v1beta` でカスタムの Gemini ネイティブ provider として設定しないでください。Gemini モデルには OpenAI 互換の Hermes 設定を使用してください。Gemini API を直接呼び出す場合は、[Gemini `generateContent` API](/api/text/gemini-generating-content) を使用してください。
</Warning>

<Steps>
  <Step title="CometAPI キーを保存する">
    `~/.hermes/.env` を開き、以下の値を追加します:

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `COMETAPI_KEY` は名前付きの Claude provider で使用されます。`OPENAI_API_KEY` は、Hermes のカスタム OpenAI 互換エンドポイントのフォールバックを機能させるために使用されます。
  </Step>

  <Step title="OpenAI 互換ルートを設定する">
    このルートは、Hermes から使用する Gemini モデルを含む、ほとんどの CometAPI テキストモデルで使用します。`~/.hermes/config.yaml` を開き、`model` セクションが次のようになっていることを確認してください:

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    `your-model-id` を、[CometAPI Models page](https://www.cometapi.com/models/) にある現在のテキスト model ID に置き換えてください。

    <Note>
      API キーは `~/.hermes/.env` に保持してください。`config.yaml` にシークレットをハードコードしないでください。
    </Note>

    <Note>
      この設定はメインのチャットモデルを構成します。Hermes は、vision や web extraction などのタスクのために、個別の補助モデルを使用できます。
    </Note>
  </Step>

  <Step title="Claude Messages ルートを設定する">
    Hermes から Anthropic Messages 経由で Claude モデルを呼び出したい場合は、このルートを使用します。`~/.hermes/config.yaml` を開き、名前付き provider を使用してください:

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    `your-claude-model-id` を、[CometAPI Models page](https://www.cometapi.com/models/) にある現在の Claude model ID に置き換えてください。

    <Note>
      このルートでは `base_url` を `https://api.cometapi.com` のままにしてください。Hermes は名前付き provider から Anthropic Messages transport を使用します。
    </Note>
  </Step>
</Steps>

## 検証

<Steps>
  <Step title="設定を確認する">
    次のコマンドで、Hermes が設定と API キーを読み取れることを確認できます:

    ```bash theme={null}
    hermes config check
    ```

    更新後に `hermes config check` で不足しているオプションが報告された場合は、`hermes config migrate` を実行してから、もう一度確認してください。
  </Step>

  <Step title="実際のチャットテストを実行する">
    次のコマンドは、CometAPI 経由で実際のリクエストを送信します:

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    設定が成功していれば、`CONNECTED` が返され、auth または endpoint のエラーは発生しません。Claude Messages の設定が有効な場合、これにより Hermes が CometAPI 経由で `anthropic_messages` transport を使用できることも確認できます。
  </Step>
</Steps>

## オプション設定

<AccordionGroup>
  <Accordion title="クリーン再インストール（任意）">
    以前の Hermes インストールを置き換える場合は、まず組み込みのアンインストーラーを使用してください。

    ```bash theme={null}
    hermes uninstall
    ```

    アンインストーラーでは、CLI、PATH エントリ、`~/.hermes/` のデータを削除するために **Full uninstall** を選択します。その後、インストール手順を再実行し、同じ CometAPI 設定のまま続行してください。
  </Accordion>

  <Accordion title="代わりに hermes model を使う（任意）">
    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` を直接編集してください。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "CometAPI で Hermes Agent を使う",
        "description": "このガイドでは、OpenAI 互換チャットまたは Anthropic Messages の設定を通じて Hermes Agent を CometAPI に接続する方法を説明します。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "CometAPI API key を取得する",
            "text": "CometAPI アカウントを作成または開き、ダッシュボードから有効な API key をコピーします。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Hermes Agent をインストールする",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「Hermes Agent をインストールする」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "CometAPI key を保存する",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「CometAPI key を保存する」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "OpenAI 互換ルートを設定する",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「OpenAI 互換ルートを設定する」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Claude Messages ルートを設定する",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「Claude Messages ルートを設定する」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "設定を確認する",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「設定を確認する」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "実際のチャットテストを実行する",
            "text": "「CometAPI で Hermes Agent を使う」ガイドの「実際のチャットテストを実行する」手順を完了します。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI ドキュメント",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "連携",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI で Hermes Agent を使う",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>