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

# Hermes Agent mit CometAPI verwenden

> Verwenden Sie diese Anleitung, um Hermes Agent über OpenAI-kompatible Chat- oder Anthropic Messages-Einstellungen mit CometAPI zu verbinden.

Verwenden Sie [CometAPI](https://www.cometapi.com) als model-Anbieter für [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes unterstützt in dieser Anleitung zwei CometAPI-Wege: einen allgemeinen OpenAI-kompatiblen Endpunkt für die meisten Textmodelle und eine Claude-Route über Anthropic Messages.

## Voraussetzungen

* Git
* Ein CometAPI-Konto mit einem aktiven API-Schlüssel
* Ein Terminal unter macOS, Linux oder WSL2

## Installation

<Steps>
  <Step title="Holen Sie sich Ihren CometAPI API-Schlüssel">
    Melden Sie sich in der [CometAPI-Konsole](https://www.cometapi.com/console/token) an. Klicken Sie auf **Add API Key** und kopieren Sie Ihren CometAPI API-Schlüssel.

    <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 mit der Schaltfläche „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="CometAPI-API-Schlüsseldetails mit angezeigter Basis-URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Hermes Agent installieren">
    Der folgende Befehl führt das offizielle Installationsprogramm aus:

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

    Wenn die aktuelle Shell den Befehl `hermes` noch nicht erkennt, laden Sie die Shell-Konfiguration neu:

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

    <Note>
      Hermes speichert die Konfiguration in `~/.hermes/`, verlinkt den Befehl `hermes` in `~/.local/bin` und fügt möglicherweise `~/.local/bin` zu Ihrem Shell-PATH hinzu.
    </Note>
  </Step>
</Steps>

## Konfiguration

Wählen Sie die CometAPI-Route, die zur Modellfamilie passt:

| Modellfamilie                 | Hermes-Konfiguration                                                                                       | CometAPI-Route              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------- |
| OpenAI-kompatible Textmodelle | `model.provider: custom` mit `base_url: https://api.cometapi.com/v1`                                       | `/v1/chat/completions`      |
| Claude-Modelle                | Benannter provider mit `transport: anthropic_messages`                                                     | `/v1/messages`              |
| Gemini-Modelle in Hermes      | Verwenden Sie die OpenAI-kompatible Konfiguration                                                          | `/v1/chat/completions`      |
| Direkte Gemini-API-Aufrufe    | Verwenden Sie die [Gemini `generateContent` API](/api/text/gemini-generating-content) außerhalb von Hermes | `/v1beta` `generateContent` |

<Warning>
  Konfigurieren Sie Hermes nicht mit `https://api.cometapi.com/v1beta` als benutzerdefiniertem Gemini-nativen provider. Verwenden Sie für Gemini-Modelle die OpenAI-kompatible Hermes-Konfiguration. Für direkte Gemini-API-Aufrufe verwenden Sie die [Gemini `generateContent` API](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Speichern Sie Ihren CometAPI-Schlüssel">
    Öffnen Sie `~/.hermes/.env` und fügen Sie die folgenden Werte hinzu:

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

    `COMETAPI_KEY` wird vom benannten Claude-provider verwendet. `OPENAI_API_KEY` sorgt dafür, dass Hermes' Fallback für benutzerdefinierte OpenAI-kompatible Endpunkte funktioniert.
  </Step>

  <Step title="Konfigurieren Sie die OpenAI-kompatible Route">
    Verwenden Sie diese Route für die meisten CometAPI-Textmodelle, einschließlich Gemini-Modelle, die aus Hermes heraus verwendet werden. Öffnen Sie `~/.hermes/config.yaml` und stellen Sie sicher, dass der Abschnitt `model` so aussieht:

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

    Ersetzen Sie `your-model-id` durch eine aktuelle Textmodell-ID von der [CometAPI Models page](https://www.cometapi.com/models/).

    <Note>
      Belassen Sie den API-Schlüssel in `~/.hermes/.env`. Hinterlegen Sie keine Secrets direkt in `config.yaml`.
    </Note>

    <Note>
      Diese Einrichtung konfiguriert das primäre Chat-Modell. Hermes kann separate Hilfsmodelle für Aufgaben wie Vision oder Web-Extraktion verwenden.
    </Note>
  </Step>

  <Step title="Konfigurieren Sie die Claude Messages-Route">
    Verwenden Sie diese Route, wenn Hermes Claude-Modelle über Anthropic Messages aufrufen soll. Öffnen Sie `~/.hermes/config.yaml` und verwenden Sie einen benannten 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
    ```

    Ersetzen Sie `your-claude-model-id` durch eine aktuelle Claude-Modell-ID von der [CometAPI Models page](https://www.cometapi.com/models/).

    <Note>
      Belassen Sie `base_url` für diese Route bei `https://api.cometapi.com`. Hermes verwendet den Anthropic Messages-Transport des benannten providers.
    </Note>
  </Step>
</Steps>

## Verifizierung

<Steps>
  <Step title="Überprüfen Sie die Konfiguration">
    Der folgende Befehl bestätigt, dass Hermes die Konfiguration und den API-Schlüssel lesen kann:

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

    Wenn `hermes config check` nach einem Update fehlende Optionen meldet, führen Sie `hermes config migrate` aus und prüfen Sie erneut.
  </Step>

  <Step title="Führen Sie einen echten Chat-Test aus">
    Der folgende Befehl sendet eine echte Anfrage über CometAPI:

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

    Eine erfolgreiche Einrichtung gibt `CONNECTED` zurück und zeigt keine Authentifizierungs- oder Endpunktfehler. Wenn die Claude Messages-Konfiguration aktiv ist, bestätigt dies, dass Hermes den `anthropic_messages`-Transport über CometAPI verwenden kann.
  </Step>
</Steps>

## Optionale Konfiguration

<AccordionGroup>
  <Accordion title="Saubere Neuinstallation (optional)">
    Wenn du eine ältere Hermes-Installation ersetzt, verwende zuerst das integrierte Deinstallationsprogramm:

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

    Wähle im Deinstallationsprogramm **Full uninstall**, um die CLI, den PATH-Eintrag und die Daten in `~/.hermes/` zu entfernen. Führe dann den Installationsschritt erneut aus und fahre mit derselben CometAPI-Konfiguration fort.
  </Accordion>

  <Accordion title="Stattdessen das hermes model verwenden (optional)">
    Wenn du den interaktiven Ablauf für die OpenAI-kompatible Route bevorzugst, führe `hermes model` aus und wähle **Custom endpoint**.

    Gib dann die folgenden Werte ein:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: dein CometAPI API key
    * Model: eine aktuelle CometAPI-Text-model ID

    Dieser Ablauf schreibt die OpenAI-kompatiblen Provider-Einstellungen in `config.yaml`. Für Claude Messages bearbeite `config.yaml` direkt, damit der benannte Provider `transport: anthropic_messages` beibehält.
  </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 mit CometAPI verwenden",
        "description": "Verwende diese Anleitung, um Hermes Agent über OpenAI-kompatible Chat- oder Anthropic Messages-Einstellungen mit CometAPI zu verbinden.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "CometAPI API key abrufen",
            "text": "Erstelle oder öffne dein CometAPI-Konto und kopiere dann einen aktiven API key aus dem Dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Hermes Agent installieren",
            "text": "Schließe den Schritt Hermes Agent installieren in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Deinen CometAPI key speichern",
            "text": "Schließe den Schritt Deinen CometAPI key speichern in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Die OpenAI-kompatible Route konfigurieren",
            "text": "Schließe den Schritt Die OpenAI-kompatible Route konfigurieren in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Die Claude Messages-Route konfigurieren",
            "text": "Schließe den Schritt Die Claude Messages-Route konfigurieren in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Die Konfiguration prüfen",
            "text": "Schließe den Schritt Die Konfiguration prüfen in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Einen echten Chat-Test ausführen",
            "text": "Schließe den Schritt Einen echten Chat-Test ausführen in der Anleitung Hermes Agent mit CometAPI verwenden ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Hermes Agent mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>