⚡ Hermes Agent — документация AITUNNEL

Hermes Agent от Nous Research — агент с памятью, навыками и шлюзом в мессенджеры. AITUNNEL в списке провайдеров нет: это Custom endpoint, OpenAI Chat Completions на https://api.aitunnel.ru/v1.

Зачем через AITUNNEL

Из России без VPN. Запросы на api.aitunnel.ru. Аккаунты OpenRouter / Anthropic / Nous не нужны.
Оплата в рублях, бюджет на ключе, расход в панели.
Любая модель из каталога. Id без префикса: claude-sonnet-4.6, не anthropic/claude-sonnet-4.6. Слаг со слешем уходит в OpenRouter.
Нужен контекст от 64K. Каталожные Claude / GPT / Gemini / Qwen это закрывают.

Быстрый старт

Установка
Инструкция Hermes. Нужен Git; Python, Node и остальное ставит инсталлятор.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.zshrc # или ~/.bashrc
На macOS / Windows — десктопный установщик. После CLI: hermes desktop.
Ключ AITUNNEL
Создайте ключ в панели ключей — sk-aitunnel-.
Мастер hermes model
Терминал
```
hermes model
```
Это не /model
hermes model — мастер провайдера снаружи чата. Слэш /model внутри сессии только переключает уже настроенные модели.
1. Custom endpoint (self-hosted / VLLM / etc.) — пункта AITUNNEL нет
2. Base URL: https://api.aitunnel.ru/v1 (с /v1, без слеша в конце)
3. API-ключ AITUNNEL
4. Модель: claude-sonnet-4.6 — id из каталога
5. Context length — пусто (AITUNNEL отдаёт /v1/models) или явное окно ≥ 64K
6. API mode: chat_completions
Ключ — в ~/.hermes/.env, модель и endpoint — в ~/.hermes/config.yaml.
Запуск
Терминал
```
hermes          # классический CLI
hermes --tui    # TUI
```
В баннере должны быть custom / выбранная модель. Запросы — в панели. Если пусто: hermes doctor, затем снова hermes model.

Быстрая настройка без мастера

Bare custom, без блока providers. hermes config set кладёт ключ в .env, остальное — в config.yaml:

hermes config set

hermes config set OPENAI_API_KEY sk-aitunnel-xxx
hermes config set model.provider custom
hermes config set model.base_url https://api.aitunnel.ru/v1
hermes config set model.default claude-sonnet-4.6

Для bare provider: custom ключ берётся из model.api_key или OPENAI_API_KEY в ~/.hermes/.env. AITUNNEL_API_KEY здесь не читается.

Именованный провайдер

Удобно переключать модели и не светить ключ в YAML. Секреты — ~/.hermes/.env, схема — ~/.hermes/config.yaml.

~/.hermes/.env

AITUNNEL_API_KEY=sk-aitunnel-xxx

config.yaml

providers:
  aitunnel:
    api: https://api.aitunnel.ru/v1
    key_env: AITUNNEL_API_KEY
    transport: chat_completions

model:
  default: claude-sonnet-4.6
  provider: custom:aitunnel

api — base URL (base_url / url тоже принимают)
key_env — имя переменной с ключом
transport: chat_completions — в старых конфигах это api_mode

В сессии — три двоеточия custom:<имя>:<модель>, не слэш:

/model

/model custom:aitunnel:claude-sonnet-4.6
/model custom:aitunnel:gpt-5.6-sol

Минимальный вариант без блока providers:

bare custom

model:
  default: claude-sonnet-4.6
  provider: custom
  base_url: https://api.aitunnel.ru/v1
  api_key: sk-aitunnel-xxx

Fallback и auxiliary

Если основная модель не ответила — цепочка в config.yaml или hermes fallback. Для custom явно укажите endpoint и ключ:

fallback_providers

fallback_providers:
  - provider: custom
    model: gemini-3.7-flash
    base_url: https://api.aitunnel.ru/v1
    key_env: AITUNNEL_API_KEY

Сжатие контекста, заголовки и vision по умолчанию идут в основную модель. Вынесите их на дешёвую, например gemini-3.7-flash:

auxiliary

auxiliary:
  compression:
    provider: custom:aitunnel
    model: gemini-3.7-flash
  title_generation:
    provider: custom:aitunnel
    model: gemini-3.7-flash
  vision:
    provider: custom:aitunnel
    model: gemini-3.7-flash

Слоты: compression, title_generation, vision (не title). Пока чат не стабилен, fallback не включайте. Для кода вместо Sonnet удобен gpt-5.6-sol.

Устранение неполадок

No API key / OpenRouter. Hermes по умолчанию ждёт OPENROUTER_API_KEY. hermes config get model --json, hermes doctor. Нужны provider: custom или custom:aitunnel и https://api.aitunnel.ru/v1. Не OPENAI_BASE_URL в .env.
401 / 403. Ключ в панели ключей, баланс > 0, без пробелов. Для named — AITUNNEL_API_KEY в .env и key_env: AITUNNEL_API_KEY. Для bare — OPENAI_API_KEY или model.api_key.
Model not found. Id как в каталоге: claude-sonnet-4.6. В /model — custom:aitunnel:claude-sonnet-4.6.
Контекст < 64K. Hermes отвергнет модель. Возьмите окно ≥ 64K или задайте context_length у модели в providers.aitunnel.models.
Запросы не в панели. В конфиге другой api / base_url. После правки YAML — новый hermes (чат конфиг не перечитывает). Шлюз: hermes gateway restart.
Приватность. AITUNNEL не логирует исходный код промптов. Ключ только в ~/.hermes/.env, не в git.