pimenov.ai

База знаний

Hermes Agent — самообучающийся ИИ-агент: установка и быстрый старт

Полное руководство по Hermes Agent v0.17.0: установка за 2 минуты, выбор провайдера, запуск на VPS, подключение Telegram, навыки и память. Open-source, MIT, Python 3.11.

Опубликовано Обновлено

Hermes Agent — open-source автономный ИИ-агент от Nous Research. Он живёт на вашем сервере, помнит контекст между сессиями и сам пишет себе навыки из опыта. Это руководство проведёт вас от установки за пару минут до рабочего агента в Telegram на VPS.

📌
Версия: v0.17.0 «The Reach Release» (19 июня 2026). Активная разработка, возможны breaking changes. Лицензия MIT, Python 3.11. Поддержка Linux, macOS, WSL2 и нативной Windows.
🧠
Хотите понять, как Hermes устроен внутри? Идентичность через SOUL.md, трёхуровневая память, самоэволюционирующие навыки, Curator и офлайн-оптимизация GEPA — в подробном разборе Hermes Agent изнутри.

Что такое Hermes Agent

Большинство ИИ-агентов работают по принципу «получил задачу — выполнил — забыл». Каждый новый запрос с чистого листа. Hermes устроен иначе: после задачи он анализирует, что сработало, и сохраняет решение как переиспользуемый навык (skill). В следующий раз того же типа он загружает этот навык и работает быстрее и точнее.

Это не копайлот внутри IDE и не обёртка над одним API. Hermes ставится на ваш сервер (хоть на VPS за 5 долларов, хоть на serverless), держит persistent-память о ваших проектах и предпочтениях и доступен из мессенджеров — можно писать ему в Telegram, пока он работает на облачной машине.

💡
Главная идея: чем дольше вы пользуетесь Hermes, тем он полезнее. Он копит навыки, углубляет модель пользователя и ищет ответы в своих прошлых разговорах.

Ключевые возможности

ВозможностьЧто это значит
Learning loopАвтоматическая генерация и улучшение навыков после задач. Агент сам решает, что превратить в skill
Persistent-памятьМногоуровневая память: рабочая, долгосрочная, модель пользователя. Углубляется со временем
СубагентыИзолированные субагенты с собственными терминалами и Python RPC. Теперь умеют работать в фоне
47 встроенных инструментовВеб-поиск, терминал, файлы, browser automation, vision, генерация картинок, TTS, выполнение кода, cron
15+ платформ + CLITelegram, Discord, Slack, WhatsApp, Signal, Email, iMessage, Teams и другие через единый gateway
5 sandbox-бэкендовLocal, Docker, SSH, Singularity, Modal — с container hardening и изоляцией
Cron на естественном языкеОтчёты, бэкапы, брифинги по расписанию — автономно через gateway
MCP-поддержкаПодключение любых внешних MCP-серверов
Мульти-провайдерNous Portal, OpenRouter (200+ моделей), Anthropic, OpenAI, локальные модели. Переключение командой hermes model

Установка за 2 минуты

Это основной раздел руководства. Если вы ставите Hermes впервые, идите строго по шагам — пропуск выбора провайдера ломает всё остальное.

Что понадобится

  • ОС: Linux, macOS, WSL2 или нативная Windows. Установщик сам подтянет Python 3.11, Node.js, ripgrep и ffmpeg.
  • Модель с контекстом от 64K токенов. Меньше — Hermes откажется стартовать. Claude, GPT, Gemini, Qwen, DeepSeek проходят легко.
  • Доступ к LLM: подписка Nous Portal (самый простой путь) или свой API-ключ (OpenRouter, Anthropic, OpenAI и т. д.).

Шаг 1. Установка одной командой

Linux / macOS / WSL2:

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

Windows (PowerShell):

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

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

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

Установщик ставит все зависимости, клонирует репозиторий, создаёт виртуальное окружение и глобальную команду hermes. Конфиг живёт в ~/.hermes/. На macOS и Windows можно вместо терминала скачать десктоп-установщик — он ставит и приложение, и CLI.

Шаг 2. Первичная настройка

hermes setup

Мастер предложит три режима:

  • Quick Setup (Nous Portal) — вход через OAuth без API-ключей, сразу настраивает модель и Tool Gateway (веб-поиск, генерация картинок, TTS, облачный браузер). Рекомендуемый быстрый путь.
  • Full Setup — пройти все провайдеры, инструменты и опции вручную со своими ключами.
  • Blank Slate — минимальный агент: только провайдер, файловые операции и терминал. Всё остальное выключено, включаете точечно по необходимости.

Самый короткий старт на свежей установке:

hermes setup --portal

Шаг 3. Выбор провайдера

Это самый важный шаг. Запустите интерактивный выбор:

hermes model
ПровайдерЧто этоКак подключить
Nous PortalПодписка, zero-config, 300+ моделей + встроенные инструментыOAuth-логин через hermes model
OpenRouterРоутинг по 200+ моделямВвести API-ключ
AnthropicClaude напрямуюOAuth (Max + кредиты) или API-ключ
OpenAI CodexChatGPT OAuth, модели CodexDevice-code авторизация через hermes model
Ollama / LM Studio / vLLMЛокальные моделиСвой endpoint, контекст ≥64K
💡
Провайдер не «зашит» намертво — переключайтесь между моделями командой hermes model в любой момент.

Шаг 4. Первый чат

hermes

Правило первого запуска: пока Hermes не отвечает в обычном чате, не добавляйте новые фичи. Сначала добейтесь одного чистого диалога, потом подключайте gateway, cron, навыки и голос.

Шаг 5. Запуск на VPS (always-on)

Чтобы агент работал постоянно и сам поднимался после перезагрузки сервера, ставьте gateway как systemd-сервис.

hermes gateway install        # установить как user-сервис
hermes gateway start          # запустить
hermes gateway status         # проверить статус
journalctl --user -u hermes-gateway -f   # смотреть логи

# чтобы сервис жил после выхода из сессии:
sudo loginctl enable-linger $USER

На headless-VPS, который должен подниматься при загрузке без linger, ставьте системный сервис:

sudo hermes gateway install --system
sudo hermes gateway start --system
🔴
Никогда не запускайте gateway под root. Заведите отдельного непривилегированного пользователя — это поддерживается и безопаснее.

Шаг 6. Подключение Telegram

hermes gateway setup          # интерактивная настройка платформ

Мастер проведёт через подключение Telegram, Discord, Slack, WhatsApp и других. По умолчанию gateway запрещает всех, кто не в allowlist или не прошёл DM-пейринг — это безопасный дефолт для бота с доступом к терминалу.

Как работает пейринг: неизвестный пользователь пишет боту, получает одноразовый код, а вы подтверждаете его с CLI:

hermes pairing approve telegram XKGH5N7P   # подтвердить по коду
hermes pairing list                        # ожидающие и одобренные
hermes pairing revoke telegram 123456789   # отозвать доступ

Коды живут 1 час, ограничены по частоте и используют криптослучайность.

Устранение неполадок

ПроблемаРешение
hermes: command not foundПерезагрузите шелл (source ~/.bashrc) или проверьте PATH
API key not setЗапустите hermes model или hermes config set OPENROUTER_API_KEY ваш_ключ
Пропал конфиг после обновленияhermes config check, затем hermes config migrate
Непонятно, что сломалосьhermes doctor — покажет, чего не хватает и как починить

Обновляется агент командой hermes update — она сама определит способ установки и подскажет нужную команду.


Что нового в v0.17.0 «The Reach Release»

Крупное обновление от 19 июня 2026. Главное про «дотянуться» — новые каналы связи, более глубокая интеграция с инструментами и работа в команде. Закрыто 300+ issue плюс раунд безопасности.

  • iMessage через Photon — плагин на управляемом пуле номеров. hermes photon login, код устройства — и Hermes шлёт и принимает iMessage без Mac-реле в шкафу и без BlueBubbles. Позиционируется как преемник BlueBubbles.
  • Сеть Raft — Hermes подключается к Raft как внешний агент через wake-channel мост.
  • Фоновые субагентыdelegate_task(background=true) запускает субагента в фоне и сразу возвращает управление. Вы и модель продолжаете работать, а результат вливается в разговор, как только субагент закончит.
  • Десктоп-приложение возмужало — теперь это полноценный daily driver с деревом субагентов и встроенным терминалом, а не превью.
  • Profile builder в дашборде — полный профиль (модель, навыки, MCP-серверы) собирается в браузере без ручной правки config.yaml, плюс единый машинный вид со switcher'ом профилей.
  • Переработанный Skills Hub — подключаемые хабы, раздел Featured, полное превью навыка перед установкой и security-скан на каждый skill.
  • Апгрейд инструмента memory — массив operations применяет пачку add/replace/remove атомарно против бюджета символов. То, что раньше было хрупким многоходовым танцем, стало одной надёжной операцией.
  • Cursor Composer через подписку xAI Grok — связка из вашего тарифа Grok, агентного цикла Hermes и скорости Composer.

Навыки, память и субагенты

Эти три механизма и дают Hermes глубину со временем.

Навыки (skills) — это инструкции по конкретной задаче в формате SKILL.md: название, описание и пошаговая процедура. Агент читает короткие описания бесплатно и грузит полное содержимое навыка только когда задача реально его требует, поэтому навыки не раздувают каждый запрос.

hermes skills browse                    # всё доступное
hermes skills search kubernetes         # поиск по ключевому слову
hermes skills install openai/skills/k8s # установка (сначала security-скан)

Hermes идёт с каталогом встроенных навыков в ~/.hermes/skills/. Можно добавлять из Skills Hub или писать свои.

Память — многоуровневая и persistent: рабочая, долгосрочная и модель пользователя. После обновления v0.17.0 правки памяти стали быстрее и почти не срываются на полпути.

Субагенты — изолированные исполнители с собственными терминалами и Python RPC. Запускаете тяжёлую параллельную задачу в фоне и продолжаете диалог.

Как работает learning loop

flowchart LR
    A["Получить задачу"] --> B["Загрузить контекст + память + навыки"]
    B --> C["Выполнить задачу"]
    C --> D["Проанализировать результат"]
    D --> E{"Создать / улучшить навык?"}
    E -->|Да| F["Сохранить skill"]
    E -->|Нет| G["Обновить память"]
    F --> G
    G --> H["Углубить модель пользователя"]

Песочницы (sandbox-бэкенды)

Где именно агент выполняет команды — выбираете вы. От этого зависит изоляция.

БэкендКогда использоватьИзоляция
LocalРазработка, быстрые задачиМинимальная — полный доступ к системе
DockerПродакшен на VPSContainer hardening, read-only root
SSHУдалённый серверЗависит от хоста
ModalServerless, платите за использованиеПолная изоляция, автоскейлинг
SingularityHPC-кластерыNamespace isolation

Для постоянной работы на VPS берите Docker, для тяжёлых разовых задач — Modal.


Безопасность

У Hermes защита по принципу defense-in-depth. Что стоит включить сразу:

  • Подтверждение опасных команд. По умолчанию режим manual: на rm -r, mkfs, dd и подобное агент спрашивает разрешение. Есть «жёсткий» блоклист (например, rm -rf /), который не обойти даже через --yolo.
  • Авторизация в gateway. Используйте явные allowlist'ы или DM-пейринг, никогда не включайте GATEWAY_ALLOW_ALL_USERS=true в проде.
  • Контейнерный бэкенд. terminal.backend: docker изолирует команды агента от хоста и снимает необходимость в ручном подтверждении.
  • Секреты. Держите ключи в ~/.hermes/.env с правами chmod 600, не коммитьте их.
  • Не root. Запускайте gateway под отдельным непривилегированным пользователем.
⚠️
Режим --yolo (или approvals.mode: off) отключает все проверки. Только для доверенных окружений вроде изолированных контейнеров и CI/CD.

Тарифы и инфраструктура

Сам Hermes Agent бесплатный и open-source (MIT). Платите только за LLM и хостинг.

КомпонентСтоимостьПримечание
Hermes AgentБесплатно (MIT)Self-hosted
Nous PortalПо тарифам Nous Research300+ моделей + встроенные инструменты
OpenRouterPay-per-token200+ моделей
VPS (Hetzner)от ~350 рублей в месяцДостаточно для базового использования
Modal (serverless)около нуля в простоеПлатите только за вычисления

Рабочая схема: мощная модель (Claude Opus, GPT-5) на сложные задачи и дешёвая (Hermes-3, GPT-4o-mini) на рутину. Переключение через hermes model без правки кода.


Миграция с OpenClaw

Если вы приходите с OpenClaw, Hermes автоматически переносит навыки, память, настройки и ключи. Мастер hermes setup сам находит ~/.openclaw и предлагает миграцию, либо запустите вручную:

hermes claw migrate              # интерактивный перенос
hermes claw migrate --dry-run    # посмотреть, что перенесётся
hermes claw migrate --preset user-data   # без секретов

Коротко о разнице: OpenClaw сильнее в широте интеграций и оркестрации, Hermes — в самообучении и research-пайплайне. Они скорее дополняют друг друга, чем конкурируют: OpenClaw на ежедневные операции, Hermes на задачи, где важно накопление опыта.


Ограничения

  • Ранний проект — активная разработка, возможны breaking changes между версиями.
  • Зависимость от LLM — качество агента упирается в качество модели и стоимость API.
  • Порог входа — это self-hosted инструмент: нужен сервер и базовое умение работать с терминалом.
  • Python-стек — если инфраструктура на TypeScript, понадобится отдельное окружение.

Ссылки


По теме

Если вы выбираете, какой ИИ-агент поставить себе или в команду, и сомневаетесь между self-hosted и облачным вариантом — помогу разобраться с архитектурой под ваши задачи.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov.