Hermes Agent — автономный AI агент в терминале через AITUNNEL
Hermes Agent — open-source автономный агент с памятью и 21+ мессенджером, подключённый к 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 идёт дальше:
| Возможность | Hermes Agent | Обычный CLI-агент |
|---|---|---|
| Постоянная память | ✅ сохраняется между сессиями | ❌ только в рамках сессии |
| Самообучение | ✅ создаёт навыки автоматически | ❌ |
| Каналы связи | ✅ 21+ платформа | ❌ только терминал |
| Фоновая работа | ✅ может работать без участия человека | ❌ |
| TUI-интерфейс | ✅ современный терминальный UI | зависит от инструмента |
Агент можно запустить локально, в Docker, через SSH, на Vercel Sandbox, Modal, Daytona или Singularity — архитектура не зависит от конкретной среды выполнения.
Как Hermes подключается к внешнему API
Hermes поддерживает любой OpenAI-совместимый endpoint через механизм custom-провайдера. AITUNNEL полностью совместим с этим форматом — достаточно один раз прописать base_url и ключ, после чего агент будет отправлять все запросы через российский endpoint без каких-либо ограничений.
Важно явно задать два параметра:
base_url: https://aitunnel.83.141.93.205.nip.io/__api/v1- провайдер
customили именованныйcustom:aitunnel
Три способа сделать это описаны ниже — выберите подходящий.
Установка Hermes Agent
Нужен Git; Python, Node и остальное ставит инсталлятор.
macOS / Linux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc # или ~/.bashrcWindows
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Получение API ключа AITUNNEL
- Зарегистрируйтесь на aitunnel.83.141.93.205.nip.io
- Откройте раздел Ключи
- Создайте новый ключ — он начинается с
sk-aitunnel- - Скопируйте ключ в безопасное место
Способ 1: интерактивный мастер (рекомендуется)
Самый простой и надёжный вариант — встроенный мастер настройки:
hermes modelМастер задаст несколько вопросов:
- Выберите тип провайдера →
Custom endpoint (self-hosted / VLLM / etc.) - Base URL →
https://aitunnel.83.141.93.205.nip.io/__api/v1 - API ключ → введите
sk-aitunnel-xxx - Модель по умолчанию → например,
claude-sonnet-5.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://aitunnel.83.141.93.205.nip.io/__api/v1
hermes config set model.default claude-sonnet-5.5Каждая команда меняет одну настройку. После последней строки агент готов к работе.
> Обратите внимание: команда hermes config set не умеет создавать блок providers с именованным провайдером. Для именованного провайдера (custom:aitunnel) нужна ручная правка конфига.
Способ 3: ручная настройка конфига
Ручная настройка даёт больший контроль и позволяет использовать именованный провайдер, что удобно при переключении между несколькими API.
Шаг 1: ключ в .env
Откройте или создайте файл ~/.hermes/.env:
AITUNNEL_API_KEY=sk-aitunnel-xxxHermes намеренно хранит секреты отдельно от конфига — ключи в .env, всё остальное в config.yaml.
Шаг 2: именованный провайдер в config.yaml
Откройте ~/.hermes/config.yaml и добавьте блок:
providers:
aitunnel:
api: https://aitunnel.83.141.93.205.nip.io/__api/v1
key_env: AITUNNEL_API_KEY
transport: chat_completions
model:
default: claude-sonnet-5.5
provider: custom:aitunnelИменованный провайдер удобен тем, что позволяет переключать модели без редактирования файла. В сессии — три двоеточия custom:<имя>:<модель>, не слэш:
/model custom:aitunnel:claude-sonnet-5.5
/model custom:aitunnel:gpt-6.1-solАльтернатива: минимальная конфигурация
Если именованный провайдер не нужен, достаточно такого блока в config.yaml:
model:
default: claude-sonnet-5.5
provider: custom
base_url: https://aitunnel.83.141.93.205.nip.io/__api/v1
api_key: sk-aitunnel-xxx> При таком варианте переменная AITUNNEL_API_KEY не подхватывается — ключ нужно вписать непосредственно в model.api_key или использовать OPENAI_API_KEY в .env. Именованный провайдер предпочтительнее для продакшн-использования.
Какую модель выбрать
Hermes рассчитан на модели с контекстом от 64K токенов — системный промпт и схемы инструментов занимают значительный объём. Вот ориентир по выбору:
| Задача | Модель | Примечание |
|---|---|---|
| Агентные задачи, флагман | claude-opus-5.5 | 1M токенов контекста |
| Самые сложные задачи | claude-fable-5.2 | Миграции, сложный код, долгие рассуждения |
| Программирование | claude-sonnet-5.5 | Баланс скорости и качества |
| Скорость + экономия | gemini-3.8-flash | Отлично для auxiliary-задач |
| Анализ, мультимодальность | gemini-4-argon | 1M токенов, текст, картинки, видео и аудио |
| Агенты с большим потоком запросов | gemini-4-hydrogen | Экономичная модель Gemini 4 |
| Код и рассуждения OpenAI | gpt-6.1-sol | Сильный в программировании |
| Бюджетный вариант | deepseek-v4.1-flash | Минимальные затраты |
Все ID доступны на странице моделей AITUNNEL.
Резервные модели — на случай недоступности
Hermes поддерживает цепочку fallback-моделей: если основная недоступна или вернула ошибку, агент автоматически переключается на следующую — без прерывания диалога:
fallback_providers:
- provider: custom
model: gemini-3.8-flash
base_url: https://aitunnel.83.141.93.205.nip.io/__api/v1
key_env: AITUNNEL_API_KEYЭто особенно полезно при долгих автономных сессиях, когда агент работает в фоне и вы не контролируете каждый запрос.
Вспомогательные модели для фоновых задач
Hermes использует отдельные модели для служебных операций: сжатие контекста, генерация заголовков сессий, vision, суммаризация страниц. По умолчанию всё идёт через основную модель — это может быть дорого. Оптимизация: вынести фоновые задачи на дешёвую быструю модель:
auxiliary:
title_generation:
provider: custom:aitunnel
model: gemini-3.8-flash
vision:
provider: custom:aitunnel
model: gemini-3.8-flash
compression:
provider: custom:aitunnel
model: gemini-3.8-flashТяжёлая модель остаётся для рассуждений и кода — всё остальное обходится дешевле. Это один из ключевых рычагов снижения расходов при интенсивном использовании.
Мониторинг расходов
Все запросы, отправленные через AITUNNEL, отображаются в личном кабинете:
- расходы по моделям с разбивкой по токенам
- история каждого запроса
- текущий баланс и уведомления
Это позволяет понять, какие операции Hermes выполняет чаще всего и где можно сэкономить за счёт более дешёвых auxiliary-моделей.
Устранение частых проблем
Ошибка «No API key» или провайдер не найден
Почти всегда причина в том, что Hermes продолжает искать OPENROUTER_API_KEY — провайдер по умолчанию не был изменён.
Диагностика:
hermes config get model --json
hermes doctorЕсли в выводе нет https://aitunnel.83.141.93.205.nip.io/__api/v1 — провайдер не переключён. Запустите hermes model и повторите настройку.
Ошибки авторизации 401/403
- Зайдите в личный кабинет и убедитесь, что ключ активен
- Проверьте баланс — при нулевом балансе запросы отклоняются
- Убедитесь, что ключ скопирован без пробелов в начале и конце
Модель возвращает ошибку
- Проверьте ID модели на странице моделей — опечатки в названии — частая причина
- При именованном провайдере формат модели в
/model:custom:aitunnel:model-id - Убедитесь, что
base_urlзаканчивается на/v1без лишнего слеша
Ошибки длины контекста
Hermes требует минимум 64K токенов контекста. Если модель не поддерживает такое окно, добавьте в конфиг явное ограничение:
providers:
aitunnel:
api: https://aitunnel.83.141.93.205.nip.io/__api/v1
key_env: AITUNNEL_API_KEY
transport: chat_completions
models:
claude-sonnet-5.5:
context_length: 128000Или переключитесь на модель с гарантированно большим контекстом: gemini-4-argon или claude-sonnet-5.5.
Запросы не видны в AITUNNEL
Убедитесь, что запросы вообще уходят на aitunnel.83.141.93.205.nip.io:
curl https://aitunnel.83.141.93.205.nip.io/__api/v1/models \
-H "Authorization: Bearer sk-aitunnel-xxx"Если список моделей вернулся — API работает. Если запросы всё равно не появляются в панели, значит Hermes использует другой провайдер. Перезапустите агент после правки config.yaml.
Дополнительные ресурсы
- Документация AITUNNEL — custom endpoint, providers.aitunnel, chat_completions
- Документация Hermes
Преимущества связки Hermes + AITUNNEL
- Без VPN — российский endpoint
api.aitunnel.83.141.93.205.nip.io, запросы проходят без блокировок - Один ключ — Claude, GPT, Gemini, DeepSeek и другие модели через единый
base_url - Оплата в рублях — пополнение от 500₽, карты МИР и СБП
- Fallback — цепочка резервных моделей не прерывает сессию
- Мониторинг — все расходы Hermes видны в личном кабинете с разбивкой по моделям
- Для бизнеса — счёт в кабинете, УПД через ЭДО
Ключевые возможности
- Постоянная память между сессиями
- Самостоятельное создание навыков
- Fallback и auxiliary модели
- TUI и CLI интерфейс
- Локально, Docker, SSH, Vercel Sandbox
- Любая модель через AITUNNEL
- Мониторинг расходов в личном кабинете
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.