> ## 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.

# Gunakan Hermes Agent dengan CometAPI

> Gunakan panduan ini untuk menghubungkan Hermes Agent ke CometAPI melalui chat yang kompatibel dengan OpenAI atau pengaturan Anthropic Messages.

Gunakan [CometAPI](https://www.cometapi.com) sebagai penyedia model untuk [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes mendukung dua jalur CometAPI dalam panduan ini: endpoint umum yang kompatibel dengan OpenAI untuk sebagian besar model teks dan rute Claude melalui Anthropic Messages.

## Prasyarat

* Git
* Akun CometAPI dengan API key yang aktif
* Terminal di macOS, Linux, atau WSL2

## Instalasi

<Steps>
  <Step title="Dapatkan API key CometAPI Anda">
    Masuk ke [konsol CometAPI](https://www.cometapi.com/console/token). Klik **Add API Key** lalu salin API key CometAPI Anda.

    <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="Dasbor CometAPI yang menampilkan tombol Add API Key" 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="Detail API key CometAPI dengan base URL yang ditampilkan" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Instal Hermes Agent">
    Perintah berikut menjalankan installer resmi:

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

    Jika shell saat ini belum mengenali perintah `hermes`, muat ulang konfigurasi shell:

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

    <Note>
      Hermes menyimpan config di `~/.hermes/`, menautkan perintah `hermes` di `~/.local/bin`, dan mungkin menambahkan `~/.local/bin` ke PATH shell Anda.
    </Note>
  </Step>
</Steps>

## Konfigurasi

Pilih route CometAPI yang sesuai dengan keluarga model:

| Keluarga model                           | Konfigurasi Hermes                                                                         | Route CometAPI              |
| ---------------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------- |
| Model teks yang kompatibel dengan OpenAI | `model.provider: custom` dengan `base_url: https://api.cometapi.com/v1`                    | `/v1/chat/completions`      |
| Model Claude                             | Named provider dengan `transport: anthropic_messages`                                      | `/v1/messages`              |
| Model Gemini di Hermes                   | Gunakan konfigurasi yang kompatibel dengan OpenAI                                          | `/v1/chat/completions`      |
| Panggilan API Gemini langsung            | Gunakan [API Gemini `generateContent`](/api/text/gemini-generating-content) di luar Hermes | `/v1beta` `generateContent` |

<Warning>
  Jangan konfigurasi Hermes dengan `https://api.cometapi.com/v1beta` sebagai custom provider Gemini-native. Gunakan konfigurasi Hermes yang kompatibel dengan OpenAI untuk model Gemini. Untuk panggilan API Gemini langsung, gunakan [API Gemini `generateContent`](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Simpan kunci CometAPI Anda">
    Buka `~/.hermes/.env` dan tambahkan nilai berikut:

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

    `COMETAPI_KEY` digunakan oleh named provider Claude. `OPENAI_API_KEY` menjaga agar fallback endpoint kustom Hermes yang kompatibel dengan OpenAI tetap berfungsi.
  </Step>

  <Step title="Konfigurasikan route yang kompatibel dengan OpenAI">
    Gunakan route ini untuk sebagian besar model teks CometAPI, termasuk model Gemini yang digunakan dari Hermes. Buka `~/.hermes/config.yaml` dan pastikan bagian `model` terlihat seperti ini:

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

    Ganti `your-model-id` dengan model ID teks saat ini dari [halaman Models CometAPI](https://www.cometapi.com/models/).

    <Note>
      Simpan API key di `~/.hermes/.env`. Jangan hardcode secret di `config.yaml`.
    </Note>

    <Note>
      Pengaturan ini mengonfigurasi model chat utama. Hermes dapat menggunakan model bantu terpisah untuk tugas seperti vision atau ekstraksi web.
    </Note>
  </Step>

  <Step title="Konfigurasikan route Claude Messages">
    Gunakan route ini saat Anda ingin Hermes memanggil model Claude melalui Anthropic Messages. Buka `~/.hermes/config.yaml` dan gunakan named 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
    ```

    Ganti `your-claude-model-id` dengan model ID Claude saat ini dari [halaman Models CometAPI](https://www.cometapi.com/models/).

    <Note>
      Pertahankan `base_url` di `https://api.cometapi.com` untuk route ini. Hermes menggunakan transport Anthropic Messages dari named provider.
    </Note>
  </Step>
</Steps>

## Verifikasi

<Steps>
  <Step title="Periksa konfigurasi">
    Perintah berikut mengonfirmasi bahwa Hermes dapat membaca config dan API key:

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

    Jika `hermes config check` melaporkan opsi yang hilang setelah pembaruan, jalankan `hermes config migrate` lalu periksa lagi.
  </Step>

  <Step title="Jalankan uji chat nyata">
    Perintah berikut mengirim permintaan nyata melalui CometAPI:

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

    Penyiapan yang berhasil akan mengembalikan `CONNECTED` dan tidak ada error auth atau endpoint. Saat konfigurasi Claude Messages aktif, ini mengonfirmasi bahwa Hermes dapat menggunakan transport `anthropic_messages` melalui CometAPI.
  </Step>
</Steps>

## Konfigurasi opsional

<AccordionGroup>
  <Accordion title="Instal ulang bersih (opsional)">
    Jika Anda mengganti instalasi Hermes yang lebih lama, gunakan uninstaller bawaan terlebih dahulu:

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

    Di uninstaller, pilih **Full uninstall** untuk menghapus CLI, entri PATH, dan data `~/.hermes/`. Lalu jalankan kembali langkah instalasi dan lanjutkan dengan konfigurasi CometAPI yang sama.
  </Accordion>

  <Accordion title="Gunakan model hermes sebagai gantinya (opsional)">
    Jika Anda lebih memilih alur interaktif untuk rute yang kompatibel dengan OpenAI, jalankan `hermes model` dan pilih **Custom endpoint**.

    Lalu masukkan nilai berikut:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: kunci API CometAPI Anda
    * Model: model ID teks CometAPI saat ini

    Alur ini menulis pengaturan provider yang kompatibel dengan OpenAI ke dalam `config.yaml`. Untuk Claude Messages, edit `config.yaml` secara langsung agar provider bernama tersebut tetap menggunakan `transport: anthropic_messages`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "Gunakan Hermes Agent dengan CometAPI",
        "description": "Gunakan panduan ini untuk menghubungkan Hermes Agent ke CometAPI melalui chat yang kompatibel dengan OpenAI atau pengaturan Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Dapatkan kunci API CometAPI Anda",
            "text": "Buat atau buka akun CometAPI Anda, lalu salin kunci API aktif dari dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Instal Hermes Agent",
            "text": "Selesaikan langkah Install Hermes Agent dalam panduan Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Simpan kunci CometAPI Anda",
            "text": "Selesaikan langkah Store your CometAPI key dalam panduan Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Konfigurasikan rute yang kompatibel dengan OpenAI",
            "text": "Selesaikan langkah Configure the OpenAI-compatible route dalam panduan Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Konfigurasikan rute Claude Messages",
            "text": "Selesaikan langkah Configure the Claude Messages route dalam panduan Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Periksa konfigurasi",
            "text": "Selesaikan langkah Check the configuration dalam panduan Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Jalankan pengujian chat nyata",
            "text": "Selesaikan langkah Run a real chat test dalam panduan Use Hermes Agent with CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentasi CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrasi",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Gunakan Hermes Agent dengan CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>