Hermes Agent

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

Требования

Linux, macOS, WSL2 или Android (Termux)
Python 3.11+
Аккаунт на polza.ai и API-ключ

Установка

Установить Hermes Agent

Запустите инсталлятор в терминале:

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

После завершения перезагрузите оболочку:

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

Настроить провайдер

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

hermes setup

В меню выберите Custom Endpoint и следуйте инструкциям:

Поле	Значение
Base URL	`https://polza.ai/api/v1`
API Key	ваш ключ из личного кабинета
Model	`deepseek/deepseek-v4-flash`
Context window	`1000000` (уточняйте в параметрах модели)

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

Откройте файл переменных окружения:

nano ~/.hermes/.env

Добавьте строки:

OPENAI_API_KEY=<ВАШ_POLZA_API_KEY>
OPENAI_BASE_URL=https://polza.ai/api/v1

Затем откройте конфигурационный файл:

nano ~/.hermes/config.yaml

Найдите раздел model: и приведите его к виду:

model:
  default: "deepseek/deepseek-v4-flash"
  provider: "custom"
  base_url: "https://polza.ai/api/v1"

Вместо deepseek/deepseek-v4-flash можно указать любую модель, доступную на Polza.ai. Актуальный список — на странице polza.ai/models.

Запустить агента

hermes

Откроется интерактивный терминал — можно сразу начинать общаться с агентом.

Веб-дашборд

Hermes поставляется со встроенным веб-интерфейсом для управления агентом. Запустите дашборд:

hermes dashboard

По умолчанию он открывается на http://localhost:9119. Там можно просматривать сессии, управлять памятью и навыками агента.

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

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

После этого откройте http://localhost:9119 в браузере на локальной машине.

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

Создать бота в Telegram

Откройте @BotFather в Telegram и выполните:

Напишите /newbot
Придумайте имя бота (например, My Hermes)
Придумайте username (должен заканчиваться на bot, например my_hermes_bot)
Скопируйте выданный токен вида 7123456789:AAHx...

Узнать свой Telegram ID

Напишите боту @userinfobot — он пришлёт ваш числовой ID вида 123456789.

Добавить настройки в .env

nano ~/.hermes/.env

Добавьте:

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

Запустить gateway

hermes gateway start

Теперь напишите своему боту в Telegram — он ответит через Polza.ai.

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

Hermes Agent — инструмент для агентных сценариев, поэтому модели подбираются с учётом именно агентных задач: длинный горизонт выполнения, множество вызовов инструментов, стабильность при многошаговых сессиях.

Модель	ID	Для каких агентов
DeepSeek V4 Flash	`deepseek/deepseek-v4-flash`	Высокопоточные агенты: автоматизация, обработка данных, рутинные задачи. 1M контекст, $0.14/1M токенов — лучшая цена в классе
Gemini 3.1 Flash Lite	`google/gemini-3.1-flash-lite-preview`	Агенты с большим числом коротких вызовов: поиск, суммаризация, мониторинг. Быстрый и дешёвый при высоком RPS
Kimi K2.6	`moonshotai/kimi-k2.6`	Долгоживущие автономные агенты: 4000+ вызовов инструментов, сессии 12+ часов, поддержка 300 параллельных суб-агентов. Лидер Terminal-Bench 2.0 среди open-source
Qwen 3.5 Plus	`qwen/qwen3.5-plus-20260420`	Агенты для анализа больших кодовых баз и документов: единственная модель в списке с 1M контекстом при умеренной цене
GLM-5.1	`z-ai/glm-5.1`	Агенты для веб-разработки и фронтенда: #3 в Code Arena глобально, лидер SWE-bench Pro среди open-source, MIT-лицензия
Claude Opus 4.7	`anthropic/claude-opus-4.7`	Сложные многоэтапные задачи с нюансами: рефакторинг, аналитика, документы. #1 SWE-bench Pro (64.3%), #1 Vision & Document Arena
GPT-5.5	`openai/gpt-5.5`	Агенты в терминале и CLI-сценарии: лидер Terminal-Bench 2.0 (82.7%), на 40% дешевле GPT-5.4 при том же качестве

Для большинства пользователей оптимальный старт — Kimi K2.6 (лучший баланс агентных возможностей и цены) или DeepSeek V4 Flash (если важна экономия). Claude Opus 4.7 и GPT-5.5 — для задач, где важнее качество, чем стоимость.

Полный список доступных моделей — на странице polza.ai/models.

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

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

Перезагрузите оболочку:

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

Если не помогает, проверьте что ~/.local/bin есть в PATH:

echo $PATH

Ошибка авторизации — Invalid API key

Убедитесь что ключ скопирован без лишних пробелов и Unicode-символов. Проверьте содержимое файла:

cat ~/.hermes/.env | grep OPENAI_API_KEY

Если видите лишние символы — перезапишите ключ вручную.

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

Проверьте что gateway запущен:

hermes gateway status

И убедитесь что ваш Telegram ID правильно указан в TELEGRAM_ALLOWED_USERS без пробелов и комментариев в той же строке.

No messaging platforms enabled в логах

Убедитесь что TELEGRAM_BOT_TOKEN прописан без inline-комментариев:

# Неправильно:
TELEGRAM_BOT_TOKEN=токен  # comment

# Правильно:
TELEGRAM_BOT_TOKEN=токен

Начало работы

Продвинутое

Генерация медиа

Интеграции

Требования

Установка

Веб-дашборд

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

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

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

​Требования

​Установка

​Веб-дашборд

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

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

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

Требования

Установка

Веб-дашборд

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

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

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