Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://polza.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Требования

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

​
Установка

1

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

Запустите инсталлятор в терминале:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
После завершения перезагрузите оболочку:
source ~/.bashrc   # или source ~/.zshrc
2

Запустить мастер настройки

hermes setup
Мастер настройки hermes setupВ меню выберите Custom Endpoint и следуйте инструкциям:
ПолеЗначение
Base URLhttps://polza.ai/api/v1
API Keyваш ключ из личного кабинета
Modeldeepseek/deepseek-v4-flash
Context window1000000 (уточняйте в параметрах модели)
Остальные параметры можно оставить по умолчанию — просто нажимайте Enter.
Вместо deepseek/deepseek-v4-flash можно указать любую модель, доступную на Polza.ai. Актуальный список — на странице polza.ai/models.
3

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

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

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

Hermes поставляется со встроенным веб-интерфейсом для управления агентом. Запустите дашборд: 
hermes dashboard
По умолчанию он открывается на http://localhost:9119. Там можно просматривать сессии, управлять памятью и навыками агента. Веб-дашборд Hermes Agent
Дашборд хранит API-ключи — не открывайте его на публичный IP без дополнительной защиты. Для удалённого доступа используйте SSH-туннель:
ssh -L 9119:localhost:9119 user@ваш-сервер
После этого откройте http://localhost:9119 в браузере на локальной машине.

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

1

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

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

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

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

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

nano ~/.hermes/.env
Добавьте:
TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather
TELEGRAM_ALLOWED_USERS=ваш_telegram_id
4

Запустить gateway

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

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

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

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

Перезагрузите оболочку:
source ~/.bashrc   # или source ~/.zshrc
Если не помогает, проверьте что ~/.local/bin есть в PATH:
echo $PATH
Убедитесь что ключ скопирован без лишних пробелов и Unicode-символов. Проверьте содержимое файла:
cat ~/.hermes/.env | grep OPENAI_API_KEY
Если видите лишние символы — перезапишите ключ вручную.
Проверьте что gateway запущен:
hermes gateway status
И убедитесь что ваш Telegram ID правильно указан в TELEGRAM_ALLOWED_USERS без пробелов и комментариев в той же строке.
Убедитесь что TELEGRAM_BOT_TOKEN прописан без inline-комментариев:
# Неправильно:
TELEGRAM_BOT_TOKEN=токен  # comment

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