Перейти к основному содержанию

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 — мульти-провайдерный AI-агент-фреймворк от Nous Research. Поддерживает OAuth, API-ключи и кастомные endpoint-ы, умеет работать через Telegram, Discord, Slack, WhatsApp, Signal и другие платформы. Самый надёжный способ подключить Hermes к RuAPI — использовать «Custom endpoint» (OpenAI-совместимый).

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

1

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

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

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

Linux / macOS / WSL2 поддерживаются полноценно. Нативная Windows-сборка пока early beta — если ловите баги, переходите на WSL2.

​
Установка Hermes

Одной строкой:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Перезагрузите shell:
source ~/.bashrc    # или: source ~/.zshrc
Проверка: 
hermes --version

​
Настройка endpoint-а

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

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

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

Base URL

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

API-ключ

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

Имя endpoint-а

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

Выбор модели

Популярные варианты:
  • gpt-5 (семейство OpenAI)
  • claude-sonnet-4-6 (доступна и через OpenAI-совместимый протокол на RuAPI)
  • deepseek-chat, kimi-k2.5, glm-5 и др.
Полный список — в галерее моделей.
После мастера в ~/.hermes/config.yaml появится: 
model:
  provider: "custom"
  default: "gpt-5"
  base_url: "https://www.ruapi.ai/v1"

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

Запустите CLI: 
hermes
В чате: 
> Расскажи о себе в одном предложении.
Нормальный ответ + соответствующая запись в Консоли RuAPI → Логи = всё работает.

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

Внутри сессии: 
/model gpt-5
/model claude-opus-4-7
/model custom:любая-модель-на-RuAPI
Или выйдите и повторно запустите hermes model, чтобы поменять модель по умолчанию.

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

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

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

  • Проверьте строку с API-ключом в ~/.hermes/.env — должен быть токен RuAPI, скопирован полностью.
  • Статус ключа — в Консоли RuAPI → Токены.
  • Такой 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-5, claude-sonnet-4-6 — поддерживают).

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

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