> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Как подключить Hermes Agent от Nous Research к RuAPI

[Hermes Agent](https://github.com/NousResearch/hermes-agent) — фреймворк для AI-агентов от Nous Research с поддержкой нескольких провайдеров. Поддерживает OAuth, API-ключи и кастомные эндпоинты, умеет работать через Telegram, Discord, Slack, WhatsApp, Signal и другие платформы.

Самый надёжный способ подключить Hermes к RuAPI — использовать **«Custom endpoint»** (OpenAI-совместимый).

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

<Steps>
  <Step title="Аккаунт RuAPI и API-ключ">
    Консоль → **Токены** → создайте ключ `sk-...`.
  </Step>

  <Step title="Операционная система">
    Linux / macOS / WSL2 поддерживаются полноценно. Нативная Windows-сборка пока early beta — если ловите баги, переходите на WSL2.
  </Step>
</Steps>

## Установка Hermes

<Tabs>
  <Tab title="Linux / macOS / WSL2">
    Одной строкой:

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

    Перезагрузите shell:

    ```bash theme={null}
    source ~/.bashrc    # или: source ~/.zshrc
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
    ```

    Установщик подтягивает Python 3.11, uv, Node.js, ripgrep, ffmpeg и portable Git Bash.
  </Tab>
</Tabs>

Проверка:

```bash theme={null}
hermes --version
```

## Настройка эндпоинта

Запустите мастер настройки модели:

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

Шаги:

<Steps>
  <Step title="Выберите 'Custom endpoint'">
    Мастер покажет встроенных провайдеров (Nous Portal / OpenRouter / Anthropic / OpenAI / ...). Пролистайте до конца и выберите **Custom endpoint (self-hosted / VLLM / etc.)**.
  </Step>

  <Step title="Base URL">
    ```
    https://www.ruapi.ai/v1
    ```

    <Warning>
      Протокол OpenAI-совместимый — URL **обязательно** заканчивается на `/v1`.
    </Warning>
  </Step>

  <Step title="API-ключ">
    Вставьте токен RuAPI `sk-...`. Hermes сохранит его в `~/.hermes/.env`.
  </Step>

  <Step title="Имя эндпоинта">
    Например, `RuAPI`. Hermes автоматически создаст credential pool с этим именем.
  </Step>

  <Step title="Выбор модели">
    Популярные семейства:

    * GPT (OpenAI)
    * Claude Sonnet (доступна и через OpenAI-совместимый протокол на RuAPI)
    * DeepSeek и др.

    Точные имена и полный список — на [странице цен](https://www.ruapi.ai/pricing).
  </Step>
</Steps>

После мастера в `~/.hermes/config.yaml` появится:

```yaml theme={null}
model:
  provider: "custom"
  default: "gpt-5.4"
  base_url: "https://www.ruapi.ai/v1"
```

## Первый запрос

Запустите CLI:

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

В чате:

```
> Расскажи о себе в одном предложении.
```

Нормальный ответ + соответствующая запись в Консоли RuAPI → **Логи** = всё работает.

## Переключение моделей

Внутри сессии:

```
/model claude-opus-4-8
/model custom:claude-opus-4-8
```

Или выйдите и повторно запустите `hermes model`, чтобы поменять модель по умолчанию.

## Подключение Telegram / Discord и др.

После настройки модели поднимите gateway:

```bash theme={null}
hermes gateway setup
hermes gateway start
```

Следуйте подсказкам (Telegram bot token и т. д.). Когда gateway запущен — сообщения с этих платформ автоматически идут через RuAPI. Подробнее — в [документации Hermes Messaging Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).

## Решение проблем

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    * Проверьте строку с API-ключом в `~/.hermes/.env` — должен быть токен **RuAPI**, скопирован полностью.
    * Статус ключа — в Консоли RuAPI → **Токены**.
  </Accordion>

  <Accordion title="404 / model not found">
    * Такой ID отсутствует на RuAPI — смотрите [страницу цен](https://www.ruapi.ai/pricing).
    * `base_url` должен заканчиваться на `/v1`.
  </Accordion>

  <Accordion title="Почему не использовать встроенный 'Anthropic' Hermes?">
    Встроенный путь Anthropic в Hermes построен вокруг OAuth и подписки Claude Max — переопределение base URL для сторонних шлюзов работает нестабильно. **Custom endpoint (OpenAI-совместимый)** — самый прямой и надёжный путь на RuAPI, и модели семейства Claude тоже доступны через него.
  </Accordion>

  <Accordion title="Использовать Nous Portal и RuAPI одновременно">
    Hermes поддерживает несколько провайдеров. Запустите `hermes model` снова, добавьте второго, а `/model` переключает их внутри сессии.
  </Accordion>

  <Accordion title="Tool / function calling не работает">
    В OpenAI-совместимом протоколе function calling передаётся без изменений. Если конкретный инструмент падает — сначала убедитесь, что модель его поддерживает (семейства GPT и Claude Sonnet поддерживают это для совместимых моделей — сверяйтесь с бейджами возможностей на [странице цен](https://www.ruapi.ai/pricing)).
  </Accordion>
</AccordionGroup>

## Продвинутое

* **Auxiliary models**: для vision / web-summarization / MoA Hermes использует вспомогательную модель, по умолчанию совпадающую с основной. Чтобы сэкономить, переопределите её на более дешёвую — см. [Auxiliary Models](https://hermes-agent.nousresearch.com/docs/user-guide/configuration).
* **Credential pools**: ротация ключей и автоматический failover — см. [Credential Pools](https://hermes-agent.nousresearch.com/docs/user-guide/features/credential-pools).