Перейти к основному содержанию
Hermes Agent — фреймворк для AI-агентов от Nous Research с поддержкой нескольких провайдеров. Поддерживает OAuth, API-ключи и кастомные эндпоинты, умеет работать через Telegram, Discord, Slack, WhatsApp, Signal и другие платформы. Чем RuAPI удобнее Nous Portal из России и как платить за модели без зарубежной карты, — коротко на странице www.ruapi.ai/hermes-agent-v-rossii; ниже — как всё настроить. Подключить Hermes к RuAPI можно двумя способами: установить плагин RuAPI (рекомендуем, он есть в официальном каталоге плагинов Hermes) или использовать встроенный в Hermes «Custom endpoint» (OpenAI-совместимый).

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

1

Аккаунт RuAPI и API-ключ

Консоль → API-ключи → создайте ключ sk-....
2

Операционная система

Linux, WSL2, Windows 10/11 и macOS на Apple Silicon — в первой группе поддержки Hermes (Tier 1). Для Windows и macOS на Apple Silicon есть ещё установщик с приложением Hermes Desktop.

Установка Hermes

Одной строкой:
Затем откройте новое окно терминала или перечитайте настройки shell: source ~/.zshrc в zsh (по умолчанию в macOS) или source ~/.bashrc в bash.
Проверка:
Если что-то не запускается, команда hermes doctor покажет, каких компонентов не хватает, и подскажет, как это исправить.

Способ 1: плагин RuAPI (рекомендуем)

Плагин RuAPI есть в официальном каталоге плагинов Hermes, нужен Hermes 0.21.5 или новее. После установки появятся два провайдера на одном ключе:
  • ruapi — модели Claude через родной Anthropic API, поэтому работают кэширование промптов и настройки thinking в Hermes;
  • ruapi-openai — GPT, Gemini, DeepSeek, Qwen, GLM, Kimi и другие модели через OpenAI-совместимый API.
1

Установите плагин

2

Укажите API-ключ

Ключ также спросит мастер hermes setup.
3

Выберите модель

Запустите hermes model, выберите RuAPI (Claude) или RuAPI (OpenAI-compatible) (остальные модели), затем модель. Можно указать сразу при запуске:
Список моделей строится по моделям, доступным вашему аккаунту; модели для картинок и видео не показываются. Исходный код плагина: RuAPI-ai/hermes-provider-ruapi.

Способ 2: без плагина, через Custom endpoint

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

Выберите 'Custom endpoint'

Мастер покажет встроенных провайдеров (Nous Portal / OpenRouter / Anthropic / OpenAI / …). Пролистайте до конца и выберите Custom endpoint (self-hosted / VLLM / etc.).
2

Base URL

Протокол OpenAI-совместимый — URL обязательно заканчивается на /v1.
3

API-ключ

Вставьте ключ RuAPI sk-.... Hermes сохранит его в ~/.hermes/.env.
4

Название подключения

Например, RuAPI. Hermes автоматически создаст credential pool с этим именем.
5

Выбор модели

Популярные семейства:
  • GPT (OpenAI)
  • Claude Sonnet (доступна и через OpenAI-совместимый протокол на RuAPI)
  • DeepSeek и др.
Точные имена и полный список — на странице цен.
После мастера в ~/.hermes/config.yaml появится:

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

Запустите CLI:
В чате:
Нормальный ответ + соответствующая запись в Консоли RuAPI → Журнал запросов = всё работает.

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

Внутри сессии:
Или выйдите и повторно запустите hermes model, чтобы поменять модель по умолчанию. Для повседневных диалогов и рутинных задач агента хватает deepseek-flash — он во много раз дешевле Claude Sonnet, а Hermes часто отправляет длинную историю в каждом запросе. С плагином RuAPI запускайте так: hermes --provider ruapi-openai --model deepseek-flash (через Custom endpoint — /model custom:deepseek-flash). Для сложной работы переключитесь на Claude: /model claude-sonnet-5-5 (через Custom endpoint — /model custom:claude-sonnet-5-5). Чтобы с плагином Claude шёл через нативный провайдер RuAPI (кэш и thinking), выберите его в hermes model.

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

После настройки модели поднимите gateway:
Следуйте подсказкам (Telegram bot token и т. д.). Когда gateway запущен — сообщения с этих платформ автоматически идут через RuAPI. Подробнее — в документации Hermes Messaging Gateway.

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

  • Проверьте строку с API-ключом в ~/.hermes/.env — должен быть ключ RuAPI, скопирован полностью.
  • Статус ключа — в Консоли RuAPI → API-ключи.
  • Такой ID отсутствует на RuAPI — смотрите страницу цен.
  • base_url должен заканчиваться на /v1.
Встроенный путь Anthropic в Hermes построен вокруг OAuth и подписки Claude Max — переопределение base URL для сторонних шлюзов работает нестабильно. Custom endpoint (OpenAI-совместимый) — самый прямой и надёжный путь на RuAPI, и модели семейства Claude тоже доступны через него.
Hermes поддерживает несколько провайдеров. Запустите hermes model снова, добавьте второго, а /model переключает их внутри сессии.
В OpenAI-совместимом протоколе function calling передаётся без изменений. Если конкретный инструмент падает — сначала убедитесь, что модель его поддерживает (уверенно с этим работают модели GPT и Claude — см. вызов функций).

Продвинутое

  • Auxiliary models: для vision / web-summarization / MoA Hermes использует вспомогательную модель, по умолчанию совпадающую с основной. Чтобы сэкономить, переопределите её на более дешёвую — см. Auxiliary Models.
  • Credential pools: ротация ключей и автоматический failover — см. Credential Pools.