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

# Użyj Hermes Agent z CometAPI

> Skorzystaj z tego przewodnika, aby połączyć Hermes Agent z CometAPI za pomocą ustawień czatu zgodnych z OpenAI lub Anthropic Messages.

Użyj [CometAPI](https://www.cometapi.com) jako dostawcy modeli dla [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes obsługuje w tym przewodniku dwie ścieżki CometAPI: ogólny endpoint zgodny z OpenAI dla większości modeli tekstowych oraz trasę Claude przez Anthropic Messages.

## Wymagania wstępne

* Git
* Konto CometAPI z aktywnym kluczem API
* Terminal w systemie macOS, Linux lub WSL2

## Instalacja

<Steps>
  <Step title="Pobierz klucz API CometAPI">
    Zaloguj się do [konsoli CometAPI](https://www.cometapi.com/console/token). Kliknij **Add API Key** i skopiuj swój klucz API CometAPI.

    <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="Panel CometAPI pokazujący przycisk 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="Szczegóły klucza API CometAPI z widocznym base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Zainstaluj Hermes Agent">
    Poniższe polecenie uruchamia oficjalny instalator:

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

    Jeśli bieżąca powłoka jeszcze nie widzi polecenia `hermes`, przeładuj konfigurację powłoki:

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

    <Note>
      Hermes przechowuje konfigurację w `~/.hermes/`, linkuje polecenie `hermes` w `~/.local/bin` i może dodać `~/.local/bin` do PATH powłoki.
    </Note>
  </Step>
</Steps>

## Konfiguracja

Wybierz trasę CometAPI, która odpowiada rodzinie modeli:

| Rodzina modeli                    | Konfiguracja Hermes                                                                  | Trasa CometAPI              |
| --------------------------------- | ------------------------------------------------------------------------------------ | --------------------------- |
| Modele tekstowe zgodne z OpenAI   | `model.provider: custom` z `base_url: https://api.cometapi.com/v1`                   | `/v1/chat/completions`      |
| Modele Claude                     | Nazwany provider z `transport: anthropic_messages`                                   | `/v1/messages`              |
| Modele Gemini w Hermes            | Użyj konfiguracji zgodnej z OpenAI                                                   | `/v1/chat/completions`      |
| Bezpośrednie wywołania API Gemini | Użyj [API Gemini `generateContent`](/api/text/gemini-generating-content) poza Hermes | `/v1beta` `generateContent` |

<Warning>
  Nie konfiguruj Hermes z `https://api.cometapi.com/v1beta` jako niestandardowego providera natywnego dla Gemini. Dla modeli Gemini użyj w Hermes konfiguracji zgodnej z OpenAI. W przypadku bezpośrednich wywołań API Gemini użyj [API Gemini `generateContent`](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Zapisz swój klucz CometAPI">
    Otwórz `~/.hermes/.env` i dodaj następujące wartości:

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

    `COMETAPI_KEY` jest używany przez nazwany provider Claude. `OPENAI_API_KEY` sprawia, że awaryjny niestandardowy endpoint zgodny z OpenAI w Hermes nadal działa.
  </Step>

  <Step title="Skonfiguruj trasę zgodną z OpenAI">
    Użyj tej trasy dla większości tekstowych modeli CometAPI, w tym modeli Gemini używanych z Hermes. Otwórz `~/.hermes/config.yaml` i upewnij się, że sekcja `model` wygląda tak:

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

    Zastąp `your-model-id` aktualnym model ID modelu tekstowego ze [strony modeli CometAPI](https://www.cometapi.com/models/).

    <Note>
      Przechowuj klucz API w `~/.hermes/.env`. Nie zapisuj sekretów na stałe w `config.yaml`.
    </Note>

    <Note>
      Ta konfiguracja ustawia główny model czatu. Hermes może używać oddzielnych modeli pomocniczych do zadań takich jak vision lub ekstrakcja z sieci.
    </Note>
  </Step>

  <Step title="Skonfiguruj trasę Claude Messages">
    Użyj tej trasy, gdy chcesz, aby Hermes wywoływał modele Claude przez Anthropic Messages. Otwórz `~/.hermes/config.yaml` i użyj nazwanego providera:

    ```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
    ```

    Zastąp `your-claude-model-id` aktualnym model ID Claude ze [strony modeli CometAPI](https://www.cometapi.com/models/).

    <Note>
      Dla tej trasy pozostaw `base_url` ustawione na `https://api.cometapi.com`. Hermes używa transportu Anthropic Messages z nazwanego providera.
    </Note>
  </Step>
</Steps>

## Weryfikacja

<Steps>
  <Step title="Sprawdź konfigurację">
    Poniższe polecenie potwierdza, że Hermes może odczytać konfigurację i klucz API:

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

    Jeśli `hermes config check` zgłasza brakujące opcje po aktualizacji, uruchom `hermes config migrate` i sprawdź ponownie.
  </Step>

  <Step title="Uruchom rzeczywisty test czatu">
    Poniższe polecenie wysyła rzeczywiste żądanie przez CometAPI:

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

    Pomyślna konfiguracja zwraca `CONNECTED` i brak błędów uwierzytelniania lub endpointu. Gdy konfiguracja Claude Messages jest aktywna, potwierdza to, że Hermes może używać transportu `anthropic_messages` przez CometAPI.
  </Step>
</Steps>

## Opcjonalna konfiguracja

<AccordionGroup>
  <Accordion title="Czysta reinstalacja (opcjonalnie)">
    Jeśli zastępujesz starszą instalację Hermes, najpierw użyj wbudowanego deinstalatora:

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

    W deinstalatorze wybierz **Full uninstall**, aby usunąć CLI, wpis PATH oraz dane `~/.hermes/`. Następnie ponownie uruchom krok instalacji i kontynuuj z tą samą konfiguracją CometAPI.
  </Accordion>

  <Accordion title="Użyj zamiast tego modelu hermes (opcjonalnie)">
    Jeśli wolisz interaktywny przepływ dla ścieżki zgodnej z OpenAI, uruchom `hermes model` i wybierz **Custom endpoint**.

    Następnie wprowadź następujące wartości:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: twój klucz API CometAPI
    * Model: aktualny model ID modelu tekstowego CometAPI

    Ten przepływ zapisuje ustawienia dostawcy zgodnego z OpenAI do `config.yaml`. W przypadku Claude Messages edytuj `config.yaml` bezpośrednio, aby nazwany dostawca zachował `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": "Używanie Hermes Agent z CometAPI",
        "description": "Skorzystaj z tego przewodnika, aby połączyć Hermes Agent z CometAPI przez czat zgodny z OpenAI lub ustawienia Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Pobierz swój klucz API CometAPI",
            "text": "Utwórz lub otwórz swoje konto CometAPI, a następnie skopiuj aktywny klucz API z panelu."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Zainstaluj Hermes Agent",
            "text": "Wykonaj krok Install Hermes Agent w przewodniku Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Zapisz swój klucz CometAPI",
            "text": "Wykonaj krok Store your CometAPI key w przewodniku Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Skonfiguruj ścieżkę zgodną z OpenAI",
            "text": "Wykonaj krok Configure the OpenAI-compatible route w przewodniku Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Skonfiguruj ścieżkę Claude Messages",
            "text": "Wykonaj krok Configure the Claude Messages route w przewodniku Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Sprawdź konfigurację",
            "text": "Wykonaj krok Check the configuration w przewodniku Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Uruchom rzeczywisty test czatu",
            "text": "Wykonaj krok Run a real chat test w przewodniku Use Hermes Agent with CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentacja CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integracje",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Używanie Hermes Agent z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>