> ## 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 з CometAPI

> Скористайтеся цим посібником, щоб підключити Hermes Agent до CometAPI через OpenAI-compatible chat або налаштування Anthropic Messages.

Використовуйте [CometAPI](https://www.cometapi.com) як провайдера model для [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). У цьому посібнику Hermes підтримує два шляхи CometAPI: загальний OpenAI-compatible endpoint для більшості текстових моделей і маршрут Claude через Anthropic Messages.

## Передумови

* Git
* Обліковий запис CometAPI з активним API key
* Термінал у macOS, Linux або WSL2

## Встановлення

<Steps>
  <Step title="Отримайте свій CometAPI API key">
    Увійдіть у [консоль CometAPI](https://www.cometapi.com/console/token). Натисніть **Add API Key** і скопіюйте свій CometAPI API key.

    <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 з кнопкою 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="Деталі API key CometAPI з показаним base URL" 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 зберігає config у `~/.hermes/`, розміщує посилання на команду `hermes` у `~/.local/bin` і може додати `~/.local/bin` до PATH вашої оболонки.
    </Note>
  </Step>
</Steps>

## Конфігурація

Виберіть маршрут CometAPI, який відповідає сімейству моделей:

| Сімейство моделей                 | Конфігурація Hermes                                                                            | Маршрут CometAPI            |
| --------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------- |
| OpenAI-compatible текстові моделі | `model.provider: custom` з `base_url: https://api.cometapi.com/v1`                             | `/v1/chat/completions`      |
| Моделі Claude                     | Іменований provider з `transport: anthropic_messages`                                          | `/v1/messages`              |
| Моделі Gemini у Hermes            | Використовуйте OpenAI-compatible конфігурацію                                                  | `/v1/chat/completions`      |
| Прямі виклики Gemini API          | Використовуйте [Gemini `generateContent` API](/api/text/gemini-generating-content) поза Hermes | `/v1beta` `generateContent` |

<Warning>
  Не налаштовуйте Hermes з `https://api.cometapi.com/v1beta` як кастомний Gemini-native provider. Для моделей Gemini використовуйте OpenAI-compatible конфігурацію 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` використовується іменованим provider для Claude. `OPENAI_API_KEY` забезпечує роботу резервного кастомного OpenAI-compatible endpoint у Hermes.
  </Step>

  <Step title="Налаштуйте OpenAI-compatible маршрут">
    Використовуйте цей маршрут для більшості текстових моделей CometAPI, зокрема моделей Gemini, які використовуються з Hermes. Відкрийте `~/.hermes/config.yaml` і переконайтеся, що розділ `model` має такий вигляд:

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

    Замініть `your-model-id` на актуальний model ID текстової моделі зі [сторінки моделей CometAPI](https://www.cometapi.com/models/).

    <Note>
      Зберігайте API key у `~/.hermes/.env`. Не вбудовуйте секрети безпосередньо в `config.yaml`.
    </Note>

    <Note>
      Це налаштування конфігурує основну chat модель. Hermes може використовувати окремі допоміжні моделі для таких завдань, як vision або web extraction.
    </Note>
  </Step>

  <Step title="Налаштуйте маршрут Claude Messages">
    Використовуйте цей маршрут, коли хочете, щоб Hermes викликав моделі Claude через Anthropic Messages. Відкрийте `~/.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` на актуальний model ID Claude зі [сторінки моделей CometAPI](https://www.cometapi.com/models/).

    <Note>
      Для цього маршруту залишайте `base_url` як `https://api.cometapi.com`. Hermes використовує транспорт Anthropic Messages від іменованого provider.
    </Note>
  </Step>
</Steps>

## Перевірка

<Steps>
  <Step title="Перевірте конфігурацію">
    Наступна команда підтверджує, що Hermes може прочитати конфігурацію та API key:

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

    Якщо після оновлення `hermes config check` повідомляє про відсутні опції, виконайте `hermes config migrate` і перевірте ще раз.
  </Step>

  <Step title="Запустіть реальний chat тест">
    Наступна команда надсилає реальний запит через CometAPI:

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

    Успішне налаштування повертає `CONNECTED` без помилок auth або endpoint. Коли конфігурація Claude Messages активна, це підтверджує, що Hermes може використовувати транспорт `anthropic_messages` через CometAPI.
  </Step>
</Steps>

## Необов’язкова конфігурація

<AccordionGroup>
  <Accordion title="Чисте перевстановлення (необов’язково)">
    Якщо ви замінюєте старішу інсталяцію Hermes, спочатку скористайтеся вбудованим деінсталятором:

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

    У деінсталяторі виберіть **Full uninstall**, щоб видалити CLI, запис PATH і дані `~/.hermes/`. Потім повторно виконайте крок інсталяції та продовжуйте з тією самою конфігурацією CometAPI.
  </Accordion>

  <Accordion title="Використати модель hermes натомість (необов’язково)">
    Якщо ви надаєте перевагу інтерактивному процесу для OpenAI-сумісного маршруту, виконайте `hermes model` і виберіть **Custom endpoint**.

    Потім введіть такі значення:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: ваш API key CometAPI
    * Model: актуальний model ID текстової моделі CometAPI

    Цей процес записує параметри OpenAI-сумісного provider у `config.yaml`. Для Claude Messages відредагуйте `config.yaml` безпосередньо, щоб іменований provider зберігав `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": "Використання Hermes Agent із CometAPI",
        "description": "Скористайтеся цим посібником, щоб підключити Hermes Agent до CometAPI через OpenAI-сумісний чат або налаштування Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Отримайте свій API key CometAPI",
            "text": "Створіть або відкрийте свій обліковий запис CometAPI, а потім скопіюйте активний API key з панелі керування."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Встановіть Hermes Agent",
            "text": "Виконайте крок Install Hermes Agent у посібнику Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Збережіть свій ключ CometAPI",
            "text": "Виконайте крок Store your CometAPI key у посібнику Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Налаштуйте OpenAI-сумісний маршрут",
            "text": "Виконайте крок Configure the OpenAI-compatible route у посібнику Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Налаштуйте маршрут Claude Messages",
            "text": "Виконайте крок Configure the Claude Messages route у посібнику Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Перевірте конфігурацію",
            "text": "Виконайте крок Check the configuration у посібнику Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Запустіть реальний тест чату",
            "text": "Виконайте крок Run a real chat test у посібнику Use Hermes Agent with CometAPI."
          }
        ]
      },
      {
        "@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": "Використання Hermes Agent із CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>