Предварительные требования
1
Аккаунт RuAPI и API-ключ
Консоль → API-ключи → создайте ключ
sk-....2
Операционная система
Linux, WSL2, Windows 10/11 и macOS на Apple Silicon — в первой группе поддержки Hermes (Tier 1). Для Windows и macOS на Apple Silicon есть ещё установщик с приложением Hermes Desktop.
Установка Hermes
- Linux / macOS / WSL2
- Windows (PowerShell)
Одной строкой:Затем откройте новое окно терминала или перечитайте настройки 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) (остальные модели), затем модель. Можно указать сразу при запуске:Способ 2: без плагина, через Custom endpoint
Запустите мастер настройки модели:1
Выберите 'Custom endpoint'
Мастер покажет встроенных провайдеров (Nous Portal / OpenRouter / Anthropic / OpenAI / …). Пролистайте до конца и выберите Custom endpoint (self-hosted / VLLM / etc.).
2
Base URL
3
API-ключ
Вставьте ключ RuAPI
sk-.... Hermes сохранит его в ~/.hermes/.env.4
Название подключения
Например,
RuAPI. Hermes автоматически создаст credential pool с этим именем.5
Выбор модели
Популярные семейства:
- GPT (OpenAI)
- Claude Sonnet (доступна и через OpenAI-совместимый протокол на RuAPI)
- DeepSeek и др.
~/.hermes/config.yaml появится:
Первый запрос
Запустите CLI:Переключение моделей
Внутри сессии: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:Решение проблем
Модель не найдена (503) или 404
Модель не найдена (503) или 404
- Такой ID отсутствует на RuAPI — смотрите страницу цен.
base_urlдолжен заканчиваться на/v1.
Почему не использовать встроенный 'Anthropic' Hermes?
Почему не использовать встроенный 'Anthropic' Hermes?
Встроенный путь Anthropic в Hermes построен вокруг OAuth и подписки Claude Max — переопределение base URL для сторонних шлюзов работает нестабильно. Custom endpoint (OpenAI-совместимый) — самый прямой и надёжный путь на RuAPI, и модели семейства Claude тоже доступны через него.
Использовать Nous Portal и RuAPI одновременно
Использовать Nous Portal и RuAPI одновременно
Hermes поддерживает несколько провайдеров. Запустите
hermes model снова, добавьте второго, а /model переключает их внутри сессии.Tool / function calling не работает
Tool / function calling не работает
В OpenAI-совместимом протоколе function calling передаётся без изменений. Если конкретный инструмент падает — сначала убедитесь, что модель его поддерживает (уверенно с этим работают модели GPT и Claude — см. вызов функций).
Продвинутое
- Auxiliary models: для vision / web-summarization / MoA Hermes использует вспомогательную модель, по умолчанию совпадающую с основной. Чтобы сэкономить, переопределите её на более дешёвую — см. Auxiliary Models.
- Credential pools: ротация ключей и автоматический failover — см. Credential Pools.