Интеграции
ИНТЕГРАЦИИ

Hermes Agent

Подключение Hermes Agent от Nous Research — самообучающегося AI-агента с Telegram, памятью и веб-дашбордом — к Hubris.

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

Требования

  • Linux / macOS / WSL2 / Android (Termux)
  • Python 3.11+
  • Аккаунт на hubris.pw и API-ключ

Установка

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

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

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

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

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

hermes setup

В меню выберите Custom Endpoint и заполните:

ПолеЗначение
Base URLhttps://api.hubris.pw/v1
API Keyваш ключ из личного кабинета
Modelнапример anthropic/claude-haiku-4.5
Context windowразмер контекста модели (см. каталог)

Остальные параметры можно оставить по умолчанию.

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

~/.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 поставляется со встроенным веб-интерфейсом для управления сессиями, памятью и навыками:

hermes dashboard

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

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

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

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

  1. У @BotFather создайте бота (/newbot), скопируйте токен.
  2. У @userinfobot узнайте свой Telegram ID.
  3. Добавьте в ~/.hermes/.env:
TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather
TELEGRAM_ALLOWED_USERS=ваш_telegram_id
  1. Запустите gateway:
hermes gateway start

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

Рекомендуемые модели

Hermes — агент с длинной сессией и многократными вызовами инструментов. Подойдут модели с хорошим tool calling:

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

Для сложных автономных задач (рефакторинг, длинные сессии) — Claude Sonnet/Opus из каталога. Фильтр «tool calling» поможет отобрать подходящие.

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

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

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

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

Invalid API key

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

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

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

No messaging platforms enabled в логах

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

Что дальше

Обновлено:

Hermes Agent · Hubris