> ## 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, или Anthropic Messages.

Используйте [CometAPI](https://www.cometapi.com) как провайдера моделей для [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). В этом руководстве Hermes поддерживает два пути работы с CometAPI: общий endpoint, совместимый с OpenAI, для большинства текстовых моделей и маршрут Claude через Anthropic Messages.

## Предварительные требования

* Git
* Аккаунт CometAPI с активным API-ключом
* Терминал на macOS, Linux или WSL2

## Установка

<Steps>
  <Step title="Получите API-ключ CometAPI">
    Войдите в [консоль CometAPI](https://www.cometapi.com/console/token). Нажмите **Add API Key** и скопируйте свой 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="Панель управления 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-ключе 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 хранит конфигурацию в `~/.hermes/`, размещает ссылку на команду `hermes` в `~/.local/bin` и может добавить `~/.local/bin` в PATH вашей оболочки.
    </Note>
  </Step>
</Steps>

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

Выберите маршрут CometAPI, соответствующий семейству моделей:

| Семейство моделей                      | Конфигурация Hermes                                                                        | Маршрут CometAPI            |
| -------------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------- |
| Текстовые модели, совместимые с OpenAI | `model.provider: custom` с `base_url: https://api.cometapi.com/v1`                         | `/v1/chat/completions`      |
| Модели Claude                          | Именованный provider с `transport: anthropic_messages`                                     | `/v1/messages`              |
| Модели Gemini в Hermes                 | Используйте конфигурацию, совместимую с OpenAI                                             | `/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 используйте в Hermes конфигурацию, совместимую с OpenAI. Для прямых вызовов 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` сохраняет работоспособность резервного пользовательского endpoint Hermes, совместимого с OpenAI.
  </Step>

  <Step title="Настройте маршрут, совместимый с OpenAI">
    Используйте этот маршрут для большинства текстовых моделей 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 Models page](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 Models page](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-совместимого провайдера в `config.yaml`. Для Claude Messages отредактируйте `config.yaml` напрямую, чтобы именованный провайдер сохранял `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>