Hermes Agent

Самообучающийся AI-агент с поддержкой Telegram, памятью и планировщиком задач

Hermes Agent

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

Требования

  • Linux, macOS, WSL2 или Android (Termux)
  • Python 3.11+
  • Аккаунт на usellm и 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
    

    В меню выберите Custom Endpoint и следуйте инструкциям:
    ПолеЗначение
    Base URLhttps://api.usellm.ru/v1
    API Keyваш ключ из личного кабинета
    Modelzai/glm-5.3-flash
    Context window1000000 (уточняйте в параметрах модели)

    Остальные параметры можно оставить по умолчанию: просто нажимайте Enter.
    Через файлы конфигурации. Откройте файл переменных окружения:
    nano ~/.hermes/.env
    

    Добавьте строку с API-ключом usellm:
    USELLM_API_KEY=usl_ваш_ключ
    

    Затем откройте конфигурационный файл:
    nano ~/.hermes/config.yaml
    

    Найдите раздел model: и приведите его к виду:
    model:
      default: zai/glm-5.3-flash
      provider: usellm
      base_url: https://api.usellm.ru/v1/
      key_env: USELLM_API_KEY
    

    Вместо zai/glm-5.3-flash можно указать любую модель, доступную на usellm. Актуальный список: на странице Модели API.

  3. Запустить агента:
    hermes
    

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

Веб-дашборд

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

Запустите дашборд:

hermes dashboard

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

Дашборд хранит 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: он ответит через usellm.

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

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

МодельIDДля каких агентов
GLM 5.3 Flashzai/glm-5.3-flashВысокопоточные агенты: автоматизация, обработка данных, рутинные задачи. Самая экономичная
Qwen3.8 Flashalibaba/qwen3.8-flashАгенты с большим числом коротких вызовов: поиск, суммаризация, мониторинг. Быстрый и дешёвый при высоком RPS
Gemini 3.8 Flashgoogle/gemini-3.8-flashМультимодальные агенты: работа с изображениями, документами, смешанным контекстом
Claude Sonnet 5anthropic/claude-sonnet-5Сложные многоэтапные задачи с нюансами: рефакторинг, аналитика, документы
GPT-6 Astraopenai/gpt-6-astraАгенты в терминале и CLI-сценарии, стабильный tool calling
Claude Fable 5.1anthropic/claude-fable-5.1Долгоживущие автономные агенты и сложные агентные задачи

Для большинства пользователей оптимальный старт: GLM 5.3 Flash (лучшая цена) или Claude Sonnet 5 (баланс качества и стоимости). Claude Fable 5.1 и GPT-6 Astra - для задач, где важнее качество, чем стоимость.

Полный список доступных моделей: на странице Модели API.

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