AITUNNEL Docs

Оформление

Интеграция 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 ключа ​

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

Настройка ​

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

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

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

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

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

Если ключ уже есть:

bash
hermes config set AITUNNEL_API_KEY sk-aitunnel-xxx

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

bash
hermes
# или
hermes --tui

Убедитесь, что в ~/.hermes/config.yaml указаны провайдер и модель (см. ручную настройку ниже), либо настройте их через hermes model.

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

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

Следующие шаги — для тех, кто редактирует конфиг напрямую. Большинству достаточно 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

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

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 не видит ключ AITUNNEL.

Решение:

  1. Проверьте .env: cat ~/.hermes/.env | grep AITUNNEL
  2. Или заново: hermes config set AITUNNEL_API_KEY sk-aitunnel-xxx
  3. Или пройдите мастер: hermes model → Custom endpoint

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

Решение:

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

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

Решение:

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

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

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

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

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

Решение:

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

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

AITUNNEL

© 2024 – настоящее время