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

# Gebruik Hermes Agent met CometAPI

> Gebruik deze handleiding om Hermes Agent met CometAPI te verbinden via OpenAI-compatibele chat- of Anthropic Messages-instellingen.

Gebruik [CometAPI](https://www.cometapi.com) als modelprovider voor [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes ondersteunt in deze handleiding twee CometAPI-routes: een algemene OpenAI-compatibele endpoint voor de meeste tekstmodellen en een Claude-route via Anthropic Messages.

## Vereisten

* Git
* Een CometAPI-account met een actieve API-sleutel
* Een terminal op macOS, Linux of WSL2

## Installatie

<Steps>
  <Step title="Haal je CometAPI API-sleutel op">
    Log in op de [CometAPI-console](https://www.cometapi.com/console/token). Klik op **Add API Key** en kopieer je CometAPI API-sleutel.

    <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="CometAPI-dashboard met de knop 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="Details van de CometAPI API-sleutel met de weergegeven basis-URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installeer Hermes Agent">
    De volgende opdracht voert het officiële installatieprogramma uit:

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

    Als de huidige shell de opdracht `hermes` nog niet ziet, laad dan de shellconfiguratie opnieuw:

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

    <Note>
      Hermes slaat configuratie op in `~/.hermes/`, koppelt de opdracht `hermes` in `~/.local/bin` en kan `~/.local/bin` toevoegen aan je shell-PATH.
    </Note>
  </Step>
</Steps>

## Configuratie

Kies de CometAPI-route die overeenkomt met de modelfamilie:

| Modelfamilie                     | Hermes-configuratie                                                                          | CometAPI-route              |
| -------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------- |
| OpenAI-compatibele tekstmodellen | `model.provider: custom` met `base_url: https://api.cometapi.com/v1`                         | `/v1/chat/completions`      |
| Claude-modellen                  | Benoemde provider met `transport: anthropic_messages`                                        | `/v1/messages`              |
| Gemini-modellen in Hermes        | Gebruik de OpenAI-compatibele configuratie                                                   | `/v1/chat/completions`      |
| Directe Gemini API-calls         | Gebruik de [Gemini `generateContent` API](/api/text/gemini-generating-content) buiten Hermes | `/v1beta` `generateContent` |

<Warning>
  Configureer Hermes niet met `https://api.cometapi.com/v1beta` als een aangepaste Gemini-native provider. Gebruik de OpenAI-compatibele Hermes-configuratie voor Gemini-modellen. Gebruik voor directe Gemini API-calls de [Gemini `generateContent` API](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Sla je CometAPI-sleutel op">
    Open `~/.hermes/.env` en voeg de volgende waarden toe:

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

    `COMETAPI_KEY` wordt gebruikt door de benoemde Claude-provider. `OPENAI_API_KEY` zorgt ervoor dat Hermes' fallback voor aangepaste OpenAI-compatibele endpoints blijft werken.
  </Step>

  <Step title="Configureer de OpenAI-compatibele route">
    Gebruik deze route voor de meeste CometAPI-tekstmodellen, inclusief Gemini-modellen die vanuit Hermes worden gebruikt. Open `~/.hermes/config.yaml` en zorg ervoor dat de sectie `model` er zo uitziet:

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

    Vervang `your-model-id` door een actueel tekst model ID van de [CometAPI Models page](https://www.cometapi.com/models/).

    <Note>
      Bewaar de API-sleutel in `~/.hermes/.env`. Hardcode geen secrets in `config.yaml`.
    </Note>

    <Note>
      Deze instelling configureert het hoofdchatmodel. Hermes kan aparte hulppmodellen gebruiken voor taken zoals vision of webextractie.
    </Note>
  </Step>

  <Step title="Configureer de Claude Messages-route">
    Gebruik deze route wanneer je wilt dat Hermes Claude-modellen aanroept via Anthropic Messages. Open `~/.hermes/config.yaml` en gebruik een benoemde 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
    ```

    Vervang `your-claude-model-id` door een actueel Claude model ID van de [CometAPI Models page](https://www.cometapi.com/models/).

    <Note>
      Houd `base_url` op `https://api.cometapi.com` voor deze route. Hermes gebruikt het Anthropic Messages-transport van de benoemde provider.
    </Note>
  </Step>
</Steps>

## Verificatie

<Steps>
  <Step title="Controleer de configuratie">
    Met de volgende opdracht bevestig je dat Hermes de config en de API-sleutel kan lezen:

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

    Als `hermes config check` na een update ontbrekende opties meldt, voer dan `hermes config migrate` uit en controleer opnieuw.
  </Step>

  <Step title="Voer een echte chattest uit">
    Met de volgende opdracht verstuur je een echte request via CometAPI:

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

    Een succesvolle setup retourneert `CONNECTED` en geen auth- of endpointfouten. Wanneer de Claude Messages-configuratie actief is, bevestigt dit dat Hermes het transport `anthropic_messages` via CometAPI kan gebruiken.
  </Step>
</Steps>

## Optionele configuratie

<AccordionGroup>
  <Accordion title="Schone herinstallatie (optioneel)">
    Als je een oudere Hermes-installatie vervangt, gebruik dan eerst het ingebouwde verwijderprogramma:

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

    Kies in het verwijderprogramma **Volledige verwijdering** om de CLI, de PATH-vermelding en de gegevens in `~/.hermes/` te verwijderen. Voer daarna de installatiestap opnieuw uit en ga verder met dezelfde CometAPI-configuratie.
  </Accordion>

  <Accordion title="Gebruik in plaats daarvan het hermes model (optioneel)">
    Als je de voorkeur geeft aan de interactieve flow voor de OpenAI-compatibele route, voer dan `hermes model` uit en kies **Custom endpoint**.

    Voer vervolgens de volgende waarden in:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: je CometAPI API key
    * Model: een actueel CometAPI tekst model ID

    Deze flow schrijft de instellingen van de OpenAI-compatibele provider naar `config.yaml`. Voor Claude Messages bewerk je `config.yaml` direct, zodat de benoemde provider `transport: anthropic_messages` behoudt.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "Hermes Agent gebruiken met CometAPI",
        "description": "Gebruik deze handleiding om Hermes Agent met CometAPI te verbinden via OpenAI-compatibele chat- of Anthropic Messages-instellingen.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Haal je CometAPI API key op",
            "text": "Maak je CometAPI-account aan of open het, en kopieer daarna een actieve API key uit het dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Installeer Hermes Agent",
            "text": "Voltooi de stap Hermes Agent installeren in de handleiding Hermes Agent gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Sla je CometAPI key op",
            "text": "Voltooi de stap Je CometAPI key opslaan in de handleiding Hermes Agent gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Configureer de OpenAI-compatibele route",
            "text": "Voltooi de stap De OpenAI-compatibele route configureren in de handleiding Hermes Agent gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Configureer de Claude Messages-route",
            "text": "Voltooi de stap De Claude Messages-route configureren in de handleiding Hermes Agent gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Controleer de configuratie",
            "text": "Voltooi de stap De configuratie controleren in de handleiding Hermes Agent gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Voer een echte chattest uit",
            "text": "Voltooi de stap Een echte chattest uitvoeren in de handleiding Hermes Agent gebruiken met CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Docs",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraties",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Hermes Agent gebruiken met CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>