Hermes Agent в Docker: изолированный запуск агента за 5 минут

Docker — самый безопасный способ запустить Hermes Agent, особенно если вы только изучаете инструмент. Агент работает внутри изолированного контейнера и не имеет доступа к файлам на вашей основной машине. Вы сами решаете, что монтировать внутрь.

В этой статье: клонируем репозиторий с GitHub, собираем образ из стабильного тега, настраиваем тома для памяти и навыков, подключаем модель, запускаем контейнер. Плюс разбор типичных ошибок, которые встречаются в первые полчаса.

Зачем Docker, если есть обычная установка

Стандартная установка Hermes через curl-скрипт ставит агента прямо в систему. Он получает доступ к вашей файловой системе, может читать и писать файлы, выполнять команды в терминале. Для опытного пользователя это удобно. Для тех, кто только знакомится с агентом, это риск.

Docker создает жесткую границу. Контейнер видит ровно то, что вы ему разрешили через тома (volumes). Остальное — недоступно. Если агент сделает что-то не то, это останется внутри контейнера, а не затронет вашу ОС.

Второй плюс — воспроизводимость. Один docker-compose.yml запускает одинаковую конфигурацию на любой машине с Docker. Ни «работало у меня, не работает у тебя», ни ручного восстановления окружения.

Максим: «Мы тестировали Hermes на GoBanana-задачах через Docker и без. В изолированном контейнере намного проще откатиться если что-то пошло не так — просто пересоздаешь контейнер с нуля. Для задач автоматизации контента это сэкономило несколько часов разбора ошибок.»

Что нужно перед началом

Три условия:

Docker Desktop или Docker Engine. На macOS и Windows — Docker Desktop с официального сайта (docker.com). На Linux — Docker Engine через пакетный менеджер: sudo apt install docker.io docker-compose-plugin -y. Проверьте установку: docker --version должен вернуть номер версии.

Git. Нужен для клонирования репозитория. На macOS идет из Xcode Command Line Tools. На Ubuntu: sudo apt install git -y. На Windows — Git for Windows с git-scm.com.

API-ключ провайдера. Без модели агент запустится, но работать не будет. Минимальные требования к модели: контекстное окно 64k токенов. Меньше — Hermes начнет терять данные на длинных задачах. Бесплатные варианты: OpenRouter (бесплатный тир с несколькими моделями), Nvidia NIM (MiniMax M 2.7 полностью бесплатно, ключ на build.nvidia.com).

Шаг 1. Клонируем репозиторий и выбираем стабильный тег

Официальный репозиторий Hermes Agent находится на GitHub по адресу github.com/nousresearch/hermes-agent. Клонируем:

git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent

Теперь важный момент, который часто пропускают. Ветка main — это актуальный код разработки. Там могут быть незавершенные изменения. Для стабильного запуска нужен конкретный релизный тег.

Смотрим доступные теги:

git tag --sort=-version:refname | head -5

Альтернативно — открываете страницу github.com/nousresearch/hermes-agent/releases и смотрите последний релиз. Берете самый свежий стабильный тег (формат v0.x.x).

Переключаетесь на него:

git checkout v0.11.0

Замените v0.11.0 на актуальный тег из релизов. Версия 0.11.0 была ключевым обновлением в апреле 2026: в ней разделили окружение выполнения и память модели, что сделало работу с длинными контекстами стабильнее.

Шаг 2. Собираем Docker-образ

Находясь в папке с репозиторием:

docker build -t hermes-agent .

Флаг -t hermes-agent — имя образа, по которому потом будете его запускать. Точка в конце — путь к Dockerfile (текущая директория).

Сборка занимает 5-15 минут в зависимости от скорости интернета: Docker скачивает базовый образ и устанавливает зависимости Python, Node.js и UV package manager.

Проверьте, что образ собрался:

docker images | grep hermes-agent

Должна появиться строка с именем hermes-agent и свежим тегом.

Шаг 3. Создаем папку для данных на хост-машине

Память Hermes, навыки и конфигурация должны жить вне контейнера. Иначе при каждом пересоздании контейнера агент забывает всё, что узнал.

Создайте папку в удобном месте:

mkdir -p ~/hermes-data

На Windows путь будет выглядеть как C:\Users\<username>\hermes-data. Запомните его — он понадобится в следующем шаге.

Структура, которая создастся внутри после первого запуска:

~/hermes-data/
├── .env                 # конфигурация провайдера и API-ключей
├── skills/              # навыки, которые агент создает из опыта
├── memory/              # персональная и рабочая память (SQLite)
└── logs/                # логи сессий

Шаг 4. Конфигурируем через docker-compose

В репозитории есть готовый docker-compose.yml. Откройте его:

cat docker-compose.yml

Типичная конфигурация выглядит так:

version: '3.8'

services:
  hermes:
    image: hermes-agent
    container_name: hermes-agent
    restart: unless-stopped
    volumes:
      - ~/hermes-data:/root/.hermes
    environment:
      - HERMES_DATA_DIR=/root/.hermes
    stdin_open: true
    tty: true

Ключевой момент — строка volumes. Она монтирует вашу папку ~/hermes-data внутрь контейнера как /root/.hermes. Именно там Hermes хранит память, навыки и конфиг. Благодаря монтированию данные переживают пересоздание контейнера.

На Windows путь в volumes пишется через слеши в стиле Linux: /c/Users/<username>/hermes-data:/root/.hermes.

Если хотите ограничить контейнер по ресурсам (рекомендуется):

    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '1.0'

Шаг 5. Первый запуск и настройка

Запускаем контейнер и сразу входим в мастер настройки:

docker run -it --rm \
  -v ~/hermes-data:/root/.hermes \
  hermes-agent \
  hermes setup

Флаги:

• it — интерактивный режим с терминалом (нужен для мастера настройки)
• -rm — контейнер удалится после выхода из настройки (данные в томе останутся)
• v ~/hermes-data:/root/.hermes — монтирование тома

Мастер настройки спросит несколько вещей.

Quick Setup или Full Setup. Quick Setup — минимальный набор вопросов, работает через минуту. Full Setup — настраиваете всё детально. Для первого запуска подойдет Quick Setup, потом всегда можно переконфигурировать через hermes setup снова.

Провайдер. Выбираете стрелками. Введите API-ключ когда попросят — на экране он не отображается, это нормально.

Модель. Убедитесь, что выбираете модель с контекстом 64k+. Hermes использует этот контекст для многошагового планирования и вызовов инструментов. Меньший контекст — обрезанные задачи и некорректные результаты.

Max Iterations. Максимальное количество вызовов инструментов за одну задачу. Для кодинговых задач ставьте 50-60. Для простых задач хватит 20-30. Слишком высокое значение — агент может циклиться на ненужных шагах и тратить токены впустую.

Tool Progress Mode. Выбор all покажет каждый вызов инструмента с кратким превью. Удобно для отладки. В продакшне достаточно final — только финальный ответ.

Session Reset Mode. Когда сбрасывать контекст сессии. inactivity + daily reset — хороший дефолт: контекст чистится при неактивности и раз в день.

Мессенджер. Telegram, Discord, Slack, WhatsApp — выбираете один для начала или пропускаете (Skip). Мессенджеры можно настроить позже.

После настройки все конфигурационные файлы запишутся в ~/hermes-data на хост-машине.

Шаг 6. Запуск через docker-compose в фоне

После настройки запускаем контейнер в фоновом режиме:

docker-compose up -d

Флаг -d (detached) — контейнер запустится в фоне и будет работать, пока вы его не остановите или не перезагрузите машину (если не настроена политика restart: unless-stopped).

Проверяем, что запустился:

docker-compose ps

Статус должен быть Up. Просмотр логов в реальном времени:

docker-compose logs -f hermes

Чтобы войти в интерактивный чат с агентом:

docker exec -it hermes-agent hermes

Если видите ASCII-лого Hermes и статусную строку с активной моделью — всё работает. Напишите что-нибудь простое для первой проверки, потом тестируйте задачи с инструментами.

Настройка томов для памяти и навыков

Hermes хранит три типа данных, и каждый важен по-своему.

Память (SQLite) — структурированная база всей истории сессий с FTS-5 индексированием. Агент может мгновенно найти, что делал три недели назад, какие инструменты использовал, что сработало. Без этого тома память обнуляется при каждом пересоздании контейнера.

Навыки (skills/) — markdown-файлы с успешными паттернами, которые Hermes создает автоматически. Нашел эффективный способ выполнить задачу — записал в навык, будет использовать дальше. Монтирование этой папки снаружи позволяет навыкам накапливаться.

Конфиг (.env) — API-ключи, настройки провайдера, параметры инструментов. Без монтирования потеряете конфиг при каждом обновлении контейнера.

Расширенная конфигурация томов в docker-compose.yml:

volumes:
  - ~/hermes-data/.env:/root/.hermes/.env
  - ~/hermes-data/skills:/root/.hermes/skills
  - ~/hermes-data/memory:/root/.hermes/memory
  - ~/hermes-data/logs:/root/.hermes/logs

Раздельное монтирование дает больше контроля: можно, например, монтировать только навыки и конфиг, оставив логи внутри контейнера.

Типичные ошибки и как их чинить

Контейнер стартует и сразу останавливается

Проверьте логи:

docker-compose logs hermes

Чаще всего причина — нет API-ключа или конфиг не нашелся. Убедитесь, что файл .env существует в папке ~/hermes-data и содержит ключ для вашего провайдера. Если файл пустой или ключа нет — запустите hermes setup снова через интерактивный запуск.

Агент отвечает, но режет длинные задачи на полпути

Модель с недостаточным контекстным окном. Проверьте, что выбранная модель дает 64k токенов и выше. Смените модель:

docker exec -it hermes-agent hermes model

Навык не работает или дает ошибку API

Некоторые навыки несовместимы с отдельными бесплатными моделями. Поведение, которое видели авторы видео: с «китайскими» open-source моделями часть навыков давала API call failed. Решение — переключить модель на Claude Sonnet 4.6 или GPT-5.4 mini для навыков, требующих точного следования формату.

Данные не сохраняются между перезапусками

Том не примонтирован. Проверьте docker-compose.yml — строка volumes должна указывать существующую папку на хост-машине. Запустите docker-compose down && docker-compose up -d после правки конфига.

docker-compose: command not found на Linux

На новых версиях Docker плагин compose вызывается иначе:

docker compose up -d

Без дефиса. Обе формы должны работать на Docker Engine 20.10+.

Таблица диагностики

Обновление до новой версии

Когда выходит новый релиз Hermes, обновление в Docker выглядит так:

cd hermes-agent
git fetch --tags
git checkout v0.12.0      # новый тег из релизов
docker build -t hermes-agent .
docker-compose down
docker-compose up -d

Данные в ~/hermes-data при этом сохраняются полностью — навыки, память, конфиг. Агент «помнит» всё, что делал до обновления.

VPS как альтернатива локальному Docker

Если хотите, чтобы Hermes работал 24/7 без зависимости от вашего компьютера — разворачивайте на VPS. Там та же Docker-установка, но агент живет на отдельном сервере.

Провайдеры вроде Hostinger и Hetzner дают VPS с Ubuntu от $5-10 в месяц. Некоторые (Hostinger) предлагают one-click install для популярных Docker-приложений, что ускоряет развертывание.

На VPS рекомендуется дополнительно закрыть Dashboard Hermes от публичного доступа через Nginx-прокси и ограничить кредитный лимит на OpenRouter ($25-50) — чтобы случайный сбой агента не опустошил счет.

Полный обзор Claude Code как альтернативы для кодинговых задач и других инструментов — в каталоге AI-инструментов VibeCoderz. Там же обзоры Cursor и Windsurf для тех, кто ищет IDE-ориентированный подход.

FAQ

Зачем Docker для Hermes, если можно поставить напрямую? Прямая установка дает агенту доступ к вашей файловой системе — он может читать, записывать и выполнять команды где угодно. Docker ограничивает доступ только тем, что вы явно разрешили через тома. Для тестирования нового агента это разумная мера предосторожности.

Будут ли навыки и память сохраняться при обновлении Hermes? Да, если настроены тома. Данные живут в ~/hermes-data на хост-машине, а не внутри контейнера. Обновление образа не затрагивает тома.

Можно ли подключить Telegram к Hermes в Docker? Да. При настройке через hermes setup выберите Telegram, введите токен от BotFather и свой Telegram User ID. Gateway запустится внутри контейнера и будет обрабатывать сообщения. Убедитесь, что контейнер запущен с политикой restart: unless-stopped, иначе после перезагрузки машины Telegram-бот не проснется.

Hermes в Docker работает медленнее, чем нативная установка? Разница на практике незаметна. Контейнер добавляет минимальные накладные расходы на изоляцию. Реальная скорость определяется API провайдера, а не Docker.

Как проверить, что агент работает корректно? Запустите docker exec -it hermes-agent hermes doctor. Команда проверяет git-окружение, API-ключи, конфигурацию инструментов и выводит статус каждого компонента.

Что такое Max Iterations и как правильно его выставить? Это максимальное количество вызовов инструментов за одну задачу. Аналог параметра max_iterations в n8n-агентах. Для кодинговых задач — 50-60. Для простых запросов — 20-30. Слишком высокое значение приводит к лишним вызовам и перерасходу токенов.

Можно ли запустить несколько экземпляров Hermes в разных контейнерах? Да. Создайте несколько сервисов в docker-compose.yml с разными именами контейнеров и разными папками для данных. Каждый экземпляр будет независимым агентом со своей памятью и навыками.

Глоссарий

Docker — платформа для запуска приложений в изолированных контейнерах. Контейнер получает доступ только к тому, что явно разрешено через настройки.

docker-compose — инструмент для запуска многоконтейнерных приложений через YAML-конфиг. Позволяет описать все настройки (тома, порты, переменные окружения) в одном файле.

Том (volume) — механизм монтирования папки хост-машины внутрь контейнера. Данные в томе сохраняются даже после удаления контейнера.

Git tag — метка конкретного коммита в репозитории. Стабильные релизы Hermes помечаются тегами вида v0.11.0.

hermes setup — команда запуска мастера настройки. Здесь настраивается провайдер, модель, мессенджеры и параметры агента.

hermes doctor — команда диагностики. Проверяет все компоненты конфигурации и выводит статус.

Gateway — процесс внутри Hermes, который обрабатывает входящие сообщения из мессенджеров. Должен быть запущен для работы Telegram, Discord и других шлюзов.

Max Iterations — максимальное количество вызовов инструментов за одну задачу. Ограничивает расход токенов и предотвращает зацикливание агента.

SQLite + FTS-5 — база данных и механизм полнотекстового поиска, которые Hermes использует для хранения и быстрого поиска по истории сессий.

Если возникли вопросы по конфигурации или хотите разобраться, как адаптировать Docker-установку под конкретные задачи, запишитесь на консультацию к Максиму.

Другие инструменты вайбкодинга и AI-агенты — в каталоге VibeCoderz.

Обновлено: май 2026