Hermes Agent — автономный AI агент в терминале через AITUNNEL

Hermes Agent — проект Nous Research, который превращает терминал в постоянно работающего AI-ассистента. В отличие от большинства CLI-агентов, Hermes не просто выполняет команды по запросу: он накапливает постоянную память между сессиями, самостоятельно создаёт навыки для повторяющихся задач и умеет общаться с вами через 21 платформу — от Telegram и Discord до SMS и Matrix.

Подключить его к AITUNNEL удобно: российский endpoint полностью совместим с OpenAI API, что Hermes и ожидает от custom-провайдера. Один ключ открывает доступ к Claude, GPT, Gemini, DeepSeek и другим моделям — без VPN и иностранных аккаунтов.

Чем Hermes отличается от других CLI-агентов

Большинство терминальных AI-инструментов работают по схеме «задал вопрос — получил ответ». Hermes идёт дальше:

Агент можно запустить локально, в Docker, через SSH, на Vercel Sandbox, Modal, Daytona или Singularity — архитектура не зависит от конкретной среды выполнения.

Как Hermes подключается к внешнему API

Hermes поддерживает любой OpenAI-совместимый endpoint через механизм custom-провайдера. AITUNNEL полностью совместим с этим форматом — достаточно один раз прописать base_url и ключ, после чего агент будет отправлять все запросы через российский endpoint без каких-либо ограничений.

Важно явно задать два параметра:

• base_url: https://api.aitunnel.ru/v1
• провайдер custom или именованный custom:aitunnel

Три способа сделать это описаны ниже — выберите подходящий.

Получение API ключа AITUNNEL

1. Зарегистрируйтесь на aitunnel.ru
2. Откройте раздел Ключи
3. Создайте новый ключ — он начинается с sk-aitunnel-
4. Скопируйте ключ в безопасное место

Способ 1: интерактивный мастер (рекомендуется)

Самый простой и надёжный вариант — встроенный мастер настройки:

hermes model

Мастер задаст несколько вопросов:

1. Выберите тип провайдера → Custom endpoint (self-hosted / VLLM / etc.)
2. Base URL → https://api.aitunnel.ru/v1
3. API ключ → введите sk-aitunnel-xxx
4. Модель по умолчанию → например, claude-sonnet-4.5

Hermes сохранит ключ в ~/.hermes/.env, а модель и endpoint — в ~/.hermes/config.yaml. После этого запускайте агент:

hermes        # классический CLI
hermes --tui  # современный TUI с боковой панелью

Способ 2: быстрая настройка через команды

Если ключ уже есть и хочется обойтись без мастера:

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.5

Каждая команда меняет одну настройку. После последней строки агент готов к работе.

> Обратите внимание: команда hermes config set не умеет создавать блок custom_providers с именованным провайдером. Для именованного провайдера (custom:aitunnel) нужна ручная правка конфига.

Способ 3: ручная настройка конфига

Ручная настройка даёт больший контроль и позволяет использовать именованный провайдер, что удобно при переключении между несколькими API.

Шаг 1: ключ в .env

Откройте или создайте файл ~/.hermes/.env:

AITUNNEL_API_KEY=sk-aitunnel-xxx

Hermes намеренно хранит секреты отдельно от конфига — ключи в .env, всё остальное в config.yaml.

Шаг 2: именованный провайдер в config.yaml

Откройте ~/.hermes/config.yaml и добавьте блок:

custom_providers:
  - name: aitunnel
    base_url: https://api.aitunnel.ru/v1
    key_env: AITUNNEL_API_KEY
    api_mode: chat_completions

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

Именованный провайдер удобен тем, что позволяет переключать модели без редактирования файла:

hermes model custom:aitunnel/gpt-4o
hermes model custom:aitunnel/gemini-2.5-pro

Альтернатива: минимальная конфигурация

Если именованный провайдер не нужен, достаточно такого блока в config.yaml:

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

> При таком варианте переменная AITUNNEL_API_KEY не подхватывается — ключ нужно вписать непосредственно в model.api_key или использовать OPENAI_API_KEY в .env. Именованный провайдер предпочтительнее для продакшн-использования.

Какую модель выбрать

Hermes рассчитан на модели с контекстом от 64K токенов — системный промпт и схемы инструментов занимают значительный объём. Вот ориентир по выбору:

Все ID доступны на странице моделей AITUNNEL.

Резервные модели — на случай недоступности

Hermes поддерживает цепочку fallback-моделей: если основная недоступна или вернула ошибку, агент автоматически переключается на следующую — без прерывания диалога:

fallback_providers:
  - provider: custom:aitunnel
    model: claude-sonnet-4.5
  - provider: custom:aitunnel
    model: gemini-2.5-flash

Это особенно полезно при долгих автономных сессиях, когда агент работает в фоне и вы не контролируете каждый запрос.

Вспомогательные модели для фоновых задач

Hermes использует отдельные модели для служебных операций: сжатие контекста, генерация заголовков сессий, vision, суммаризация страниц. По умолчанию всё идёт через основную модель — это может быть дорого. Оптимизация: вынести фоновые задачи на дешёвую быструю модель:

auxiliary:
  title:
    provider: custom:aitunnel
    model: gemini-2.5-flash
  vision:
    provider: custom:aitunnel
    model: gemini-2.5-flash
  compression:
    provider: custom:aitunnel
    model: gemini-2.5-flash

Тяжёлая модель остаётся для рассуждений и кода — всё остальное обходится дешевле. Это один из ключевых рычагов снижения расходов при интенсивном использовании.

Мониторинг расходов

Все запросы, отправленные через AITUNNEL, отображаются в личном кабинете:

• расходы по моделям с разбивкой по токенам
• история каждого запроса
• текущий баланс и уведомления

Это позволяет понять, какие операции Hermes выполняет чаще всего и где можно сэкономить за счёт более дешёвых auxiliary-моделей.

Устранение частых проблем

Ошибка «No API key» или провайдер не найден

Почти всегда причина в том, что Hermes продолжает искать OPENROUTER_API_KEY — провайдер по умолчанию не был изменён.

Диагностика:

grep -E 'provider|base_url' ~/.hermes/config.yaml

Если в выводе нет строки base_url: https://api.aitunnel.ru/v1 — провайдер не переключён. Запустите hermes model и повторите настройку.

Ошибки авторизации 401/403

1. Зайдите в личный кабинет и убедитесь, что ключ активен
2. Проверьте баланс — при нулевом балансе запросы отклоняются
3. Убедитесь, что ключ скопирован без пробелов в начале и конце

Модель возвращает ошибку

• Проверьте ID модели на странице моделей — опечатки в названии — частая причина
• При именованном провайдере формат модели в командах: custom:aitunnel/model-id
• Убедитесь, что base_url заканчивается на /v1 без лишнего слеша

Ошибки длины контекста

Hermes требует минимум 64K токенов контекста. Если модель не поддерживает такое окно, добавьте в конфиг явное ограничение:

custom_providers:
  - name: aitunnel
    base_url: https://api.aitunnel.ru/v1
    key_env: AITUNNEL_API_KEY
    api_mode: chat_completions
    context_length: 128000

Или переключитесь на модель с гарантированно большим контекстом: gemini-2.5-pro или claude-sonnet-4.5.

Запросы не видны в AITUNNEL

Убедитесь, что запросы вообще уходят на aitunnel.ru:

curl https://api.aitunnel.ru/v1/models \
  -H "Authorization: Bearer sk-aitunnel-xxx"

Если список моделей вернулся — API работает. Если запросы всё равно не появляются в панели, значит Hermes использует другой провайдер. Перезапустите агент после правки config.yaml.

Преимущества связки Hermes + AITUNNEL

• Без VPN — российский endpoint api.aitunnel.ru, запросы проходят без блокировок
• Один ключ — Claude, GPT, Gemini, DeepSeek и другие модели через единый base_url
• Оплата в рублях — пополнение от 399₽, карты МИР и СБП
• Fallback — цепочка резервных моделей не прерывает сессию
• Мониторинг — все расходы Hermes видны в личном кабинете с разбивкой по моделям
• Для бизнеса — договор, акты, счета-фактуры