Hermes Agent — открытый AI-агент от Nous Research. Работает с файлами и терминалом, сам формирует «навыки» из опыта, хранит память между сессиями, поддерживает чат через Telegram. Подключается к любому OpenAI-совместимому провайдеру.

Требования

Linux / macOS / WSL2 / Android (Termux); Windows — родная установка через PowerShell
Python 3.11–3.13 (установщик ставит свой, системный не нужен)
Аккаунт на hubris.pw и API-ключ

Установка

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Перезагрузите shell:

source ~/.bashrc   # или source ~/.zshrc

На Windows без WSL — в PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Подключение к Hubris

Через мастер настройки (рекомендуется)

hermes setup

На шаге Model & Provider выберите в списке Custom endpoint (enter URL manually) и ответьте на вопросы мастера:

Вопрос	Ответ
API base URL	`https://api.hubris.pw/v1`
API key	ваш ключ из личного кабинета
API mode	Chat Completions (или оставьте автоопределение)
Model	Hermes сам запросит наш каталог и покажет список — выберите, например, `anthropic/claude-haiku-4.5`
Context length in tokens	можно оставить пустым — определится автоматически; точное значение есть в каталоге
Display name	любое, например `Hubris`

Мастер сам сохранит ключ в ~/.hermes/.env, а адрес и модель — в ~/.hermes/config.yaml. Сменить модель позже: hermes model или /model <id> внутри сессии.

Через файлы конфигурации

~/.hermes/.env:

OPENAI_API_KEY=sk-gw-...
OPENAI_BASE_URL=https://api.hubris.pw/v1

~/.hermes/config.yaml:

model:
  default: "anthropic/claude-haiku-4.5"
  provider: "custom"
  base_url: "https://api.hubris.pw/v1"

Запуск

hermes

Откроется интерактивный терминал. Можно сразу писать задачу. Проверить подключение одной командой без интерактива:

hermes chat -Q --oneshot -q "Ответь одним словом: столица Франции?"

Веб-дашборд

Hermes поставляется со встроенным веб-интерфейсом для управления сессиями, памятью и навыками:

hermes dashboard

По умолчанию открывается на http://localhost:9119. Не открывайте на публичном IP без защиты — дашборд хранит API-ключи. Для удалённого доступа используйте SSH-туннель:

ssh -L 9119:localhost:9119 user@ваш-сервер

Подключение Telegram-бота

Hermes умеет принимать команды через Telegram.

У @BotFather создайте бота (/newbot), скопируйте токен.
У @userinfobot узнайте свой Telegram ID.
Добавьте в ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather
TELEGRAM_ALLOWED_USERS=ваш_telegram_id

Запустите gateway:

hermes gateway start

Теперь бот отвечает в Telegram через выбранную модель Hubris.

Решение проблем

`hermes: command not found` после установки

source ~/.bashrc   # или ~/.zshrc

Проверьте, что ~/.local/bin в PATH: echo $PATH.

`Invalid API key` или 401

Перепроверьте ключ в ~/.hermes/.env — без пробелов, начинается с sk-gw-. Если ключ вводили в мастере, он лежит там же под именем вида HERMES_CUSTOM_..._API_KEY.

Ошибка про модель (`model_not_found`)

ID пишется полностью, с вендором, в точности как в каталоге: anthropic/claude-haiku-4.5, а не claude-haiku-4.5. Список — в каталоге или в самом мастере hermes model.

Бот в Telegram не отвечает

Проверьте gateway: hermes gateway status.
Убедитесь, что Telegram ID правильно указан в TELEGRAM_ALLOWED_USERS, без пробелов и комментариев в той же строке.

`No messaging platforms enabled` в логах

Проверьте, что TELEGRAM_BOT_TOKEN указан без inline-комментариев в .env (TOKEN=xyz # comment ломает парсинг — комментарий выносите на отдельную строку).

Проверено на Hermes Agent 0.21.1 (выпуск 2026.9.7), 9 сентября 2026.

Что дальше

Каталог моделей — выбор по поддержке tool calling.
Управление API-ключами — отдельный ключ под Hermes.
Расходы — детализация сессий.
OpenClaw — альтернативный multi-messenger агент.

Обновлено: 9 сентября 2026 г.

ID	Когда уместна
`anthropic/claude-haiku-4.5`	быстрые типовые задачи
`openai/gpt-4o-mini`	универсальный выбор
`google/gemini-3.7-flash`	мультимодальные сценарии, большой контекст

Hermes Agent