Интеграция Hermes Agent

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

Hermes Agent — open-source автономный агент для терминала от Nous Research. У него есть постоянная память, навыки, которые агент создаёт сам, и шлюз сообщений для 21+ платформ: Telegram, Discord, Slack, WhatsApp, Signal, SMS, Matrix и других.

Hermes работает локально, в Docker, через SSH, Daytona, Modal, Vercel Sandbox или Singularity и поддерживает множество LLM-провайдеров. AITUNNEL подключается как OpenAI-совместимый endpoint — Hermes отправляет запросы на https://api.aitunnel.ru/v1.

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

Зарегистрируйтесь на aitunnel.ru
Перейдите в раздел Ключи
Создайте новый API ключ
Скопируйте его — он начинается с sk-aitunnel-

Настройка

Рекомендуется: интерактивный мастер

Самый простой способ:

bash

hermes model

Выберите Custom endpoint (self-hosted / VLLM / etc.)
Укажите base URL: https://api.aitunnel.ru/v1
Введите API ключ AITUNNEL (sk-aitunnel-...)
Выберите модель — например, claude-sonnet-4.5

Настройки сохранятся в ~/.hermes/config.yaml.

Быстрый старт (переменные окружения + config)

Важно

В отличие от OpenRouter, AITUNNEL не встроен в Hermes как отдельный провайдер. Одного API-ключа недостаточно: Hermes по умолчанию ищет OPENROUTER_API_KEY и провайдер openrouter. Нужно явно указать custom endpoint и base_url.

Если ключ уже есть, настройте endpoint и модель (ключ попадёт в ~/.hermes/.env, остальное — в config.yaml):

bash

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

Затем запустите чат:

bash

hermes
# или
hermes --tui

Для named provider (custom:aitunnel) используйте AITUNNEL_API_KEY и блок custom_providers из ручной настройки ниже — hermes config set этого блока не создаёт.

Ручная настройка

Только для опытных пользователей

Следующие шаги — для тех, кто редактирует конфиг напрямую. Большинству достаточно hermes model.

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

Добавьте ключ в ~/.hermes/.env:

bash

AITUNNEL_API_KEY=sk-aitunnel-xxx

Разделение секретов

Hermes хранит секреты отдельно от остальных настроек: ключи — в ~/.hermes/.env, модель и endpoint — в ~/.hermes/config.yaml.

Шаг 2: Named custom provider (рекомендуется)

Добавьте AITUNNEL как именованный провайдер в ~/.hermes/config.yaml:

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

Переключить модель в сессии:

bash

hermes model custom:aitunnel/gpt-4o

Альтернатива: прямой custom provider

Без custom_providers, если нужна минимальная конфигурация:

yaml

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

Для bare provider: custom Hermes берёт ключ из model.api_key в config.yaml или из OPENAI_API_KEY в ~/.hermes/.env. Переменная AITUNNEL_API_KEY здесь не подхватывается — она работает только с key_env в custom_providers.

TIP

Предпочитайте named provider (custom:aitunnel) — так проще переключать модели и настраивать резервные варианты.

Шаг 3: Запуск

bash

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

Все запросы пойдут через AITUNNEL на выбранную модель.

Формат моделей

Используйте ID моделей из списка моделей AITUNNEL. Примеры:

claude-sonnet-4.5
claude-opus-4.5
gpt-4o
gemini-2.5-pro
gemini-2.5-flash
deepseek-chat

С named provider формат в конфиге и командах: custom:aitunnel/<model-id>.

Резервные модели (fallback)

Цепочка запасных моделей, если основная недоступна:

yaml

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

При срабатывании fallback Hermes подменяет модель в текущей сессии, не обрывая диалог.

Вспомогательные модели (auxiliary)

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

yaml

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

Тяжёлая модель остаётся для рассуждений и кода, лёгкая — для фоновых задач.

Мониторинг использования

Расход и история запросов Hermes видны в личном кабинете AITUNNEL:

Токены по моделям
Стоимость запросов
История использования
Текущий баланс

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

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

Чаще всего Hermes всё ещё настроен на OpenRouter (провайдер по умолчанию) и ищет OPENROUTER_API_KEY, а не ключ AITUNNEL.

Решение:

Проверьте активный провайдер: grep -E 'provider|base_url' ~/.hermes/config.yaml
Если там provider: openrouter (или нет base_url: https://api.aitunnel.ru/v1) — переключите на custom endpoint через hermes model или ручную настройку выше
Для custom:aitunnel: cat ~/.hermes/.env | grep AITUNNEL и hermes config set AITUNNEL_API_KEY sk-aitunnel-xxx
Для bare provider: custom: ключ должен быть в model.api_key или в OPENAI_API_KEY в ~/.hermes/.env
Удалите старые ключи OpenRouter из конфига, если вы полностью переходите на AITUNNEL

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

Решение:

Проверьте ключ в личном кабинете
Убедитесь, что баланс положительный
Проверьте, что ключ не отозван и скопирован без лишних пробелов

Модель не работает

Решение:

Сверьте ID на странице моделей
Для named provider используйте формат custom:aitunnel/<model-id>
Убедитесь, что base_url — ровно https://api.aitunnel.ru/v1 (без лишнего слеша в конце пути к /v1)

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

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

Переключитесь на модель с большим окном (например, gemini-2.5-pro, claude-sonnet-4.5)
При необходимости задайте context_length в config.yaml для custom provider
Включите сжатие контекста через auxiliary.compression

Запросы не доходят до AITUNNEL

Решение:

Проверьте доступность API: curl https://api.aitunnel.ru/v1/models -H "Authorization: Bearer sk-aitunnel-xxx"
Убедитесь, что в конфиге не остался старый base_url от другого провайдера
Перезапустите Hermes после смены config.yaml

Интеграция Hermes Agent ​

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

Настройка ​

Рекомендуется: интерактивный мастер ​

Быстрый старт (переменные окружения + config) ​

Ручная настройка ​

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

Шаг 2: Named custom provider (рекомендуется) ​

Альтернатива: прямой custom provider ​

Шаг 3: Запуск ​

Формат моделей ​

Резервные модели (fallback) ​

Вспомогательные модели (auxiliary) ​

Мониторинг использования ​

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

«No API key» или провайдер не найден ​

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

Модель не работает ​

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

Запросы не доходят до AITUNNEL ​

Дополнительные ресурсы ​

Интеграция Hermes Agent

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

Настройка

Рекомендуется: интерактивный мастер

Быстрый старт (переменные окружения + config)

Ручная настройка

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

Шаг 2: Named custom provider (рекомендуется)

Альтернатива: прямой custom provider

Шаг 3: Запуск

Формат моделей

Резервные модели (fallback)

Вспомогательные модели (auxiliary)

Мониторинг использования

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

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

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

Модель не работает

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

Запросы не доходят до AITUNNEL

Дополнительные ресурсы