VibeCoderzVibeCoderz
Все статьи
Агенты и CLI2026/05/139 мин чтения

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

Запустите Hermes Agent в изолированном Docker‑контейнере за пять минут: быстрое клонирование, сборка образа, настройка томов и подключение модели. Получите безопасную, воспроизводимую среду без риска повредить систему.

Содержание (14)+

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

В этой статье: клонируем репозиторий с 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).

ПровайдерЦенаРекомендуемая модельКонтекст
Nvidia NIM$0MiniMax M 2.71M токенов
OpenRouter (бесплатный тир)$0DeepSeek V3, Llama 464k+
OpenRouter (платный)от $0.28/M токеновDeepSeek V3.264k+
Anthropic$3/M токенов (input)Claude Sonnet 4.6200k
OpenAI$2.5/M токенов (input)GPT-5.4128k
Изображение

Если от команд в терминале, ключей и настроек хочется держаться подальше, ту же работу делает программа Hermes Start для Mac и Windows: скачивает проверенную версию Hermes, помогает вставить ключ ИИ-модели и создать бота через официальный BotFather. На установку уходит около 30 минут, от вас нужны только ключ модели и короткая анкета о себе. Счет самой модели пополняется отдельно, способы оплаты меняются, поэтому актуальные проверяйте на сайте модели на дату покупки.


Шаг 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 руками, как в этой статье, бесплатно, но нужен терминал и час-полтора времени. Hermes Start делает установку за вас примерно за 30 минут и дальше остается пультом: показывает, все ли работает и сколько осталось на счете модели.


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

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

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

ТомЧто хранитВажность
.envAPI-ключи, конфигурацияКритично — без него настройка слетит
skills/Автоматически созданные навыкиВысокая — накопленный опыт агента
memory/SQLite с историей сессийВысокая — долгосрочная память
logs/Логи выполненияНизкая — для отладки

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

Изображение

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

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

docker-compose logs hermes

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

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

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

docker exec -it hermes-agent hermes model

Некоторые навыки несовместимы с отдельными бесплатными моделями. Поведение, которое видели авторы видео: с «китайскими» 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+.


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

ПроблемаПричинаКоманда/Решение
Контейнер сразу останавливаетсяНет API-ключа или конфигаdocker-compose logs hermes -> проверить .env
Агент режет задачиКонтекст модели меньше 64kdocker exec -it hermes-agent hermes model
Навык дает ошибку APIНесовместимость навыка с модельюСменить на Claude Sonnet 4.6 или GPT-5.4
Данные не сохраняютсяТом не примонтированПроверить volumes в docker-compose.yml
docker-compose не найденНовый синтаксис Dockerdocker compose без дефиса
Агент не отвечает в TelegramGateway не запущенdocker exec -it hermes-agent hermes gateway start

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

Когда выходит новый релиз 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-ориентированный подход.

Три причины завести такого помощника

Внутрь можно подключить любую нейросеть. Hermes работает с DeepSeek, ChatGPT, Gemini, Claude, YandexGPT, GigaChat, сотнями моделей через OpenRouter и локальными моделями через Ollama и LM Studio, это больше 20 поставщиков. ИИ-модель меняется без переустановки помощника: подорожала или перестала работать, поменяли за минуту, а память и навыки остались прежними. Так вы не привязаны к одной компании на годы.

Он учится и превращает решенное в навык. Решили сложную задачу, и помощник сохраняет процедуру как навык: когда применять, какие шаги, какие грабли. В следующий раз он сам подтягивает нужный навык и делает сразу правильно, без объяснений с нуля, а обычный чат каждый раз начинает с чистого листа. Навыки накапливаются в вашей папке ~/hermes-data и совместимы с открытым стандартом agentskills.io, готовых в реестрах тысячи. Ставьте только навыки из проверенных источников: через случайные работает подмена инструкций.

Composio подключает сервисы без программирования. По данным Composio, больше полутора тысяч сервисов: Google Документы и Таблицы, Notion, GitHub, Slack, календари. В чате это выглядит так: пишете «подключи Gmail», входите по логину, и готово. Помощник не советует, а сам правит документ, заполняет таблицу и заводит задачу там, где вы и так работаете.

Дополнительно помощник работает по расписанию и пишет первым: утренняя сводка или мониторинг цен приходят сами, а результатом бывает готовый файл, например документ Word, а не текст в окне. На сервере помощник работает и когда компьютер выключен, на своем компьютере только пока он включен.

Изображение

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 с разными именами контейнеров и разными папками для данных. Каждый экземпляр будет независимым агентом со своей памятью и навыками.

Чем Hermes Start отличается от самого Hermes? Hermes, бесплатный открытый помощник команды Nous Research, можно поставить самому через терминал. Hermes Start, программа для Mac и Windows, делает установку за человека: ставит Hermes, подключает Telegram и доводит до первой выполненной задачи примерно за 30 минут.



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

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


Обновлено: октябрь 2026

Автор

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

2026/05/13

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
All Posts

Читать далее

📄 Статья

Как пользоваться GPT-6 Astra в 2026 пошаговый разбор с примерами

Пользоваться GPT-6 Astra можно тремя способами. Первый: чат в ChatGPT, где на Pro, Business и Enterprise модель лежит под именем GPT-6 Pro. Второй: режимы Work и Codex, куда Astra пустили даже подписчиков Plus. Третий: GPT-6 API с идентификатором gpt…

2026/10/1211 мин
📄 Статья

GPT-6 Sol, Luna и Codex 2026 что уже вышло, а что слухи

Данные о моделях и ценах по состоянию на 6 октября 2026.

2026/10/1212 мин
📄 Статья

Kimi Slides для презентаций: обзор и доступность в России

Kimi Slides собирает презентацию из темы, текста или загруженного файла и отдает ее в PowerPoint, Google Slides или PNG. Это инструмент китайской компании Moonshot AI, бесплатный режим у него есть. Ниже разберем, что умеет эта нейросеть для презентац…

2026/10/069 мин
📄 Статья

Модели для Ollama в 2026: Qwen3-Coder, Kimi, DeepSeek и какую выбрать под своё железо

Короткий ответ: под 8 ГБ видеопамяти берите Qwen2.5-Coder 7B, под 24 ГБ — Qwen3-Coder-30B-A3B, а Kimi K2.6 и Hermes на домашнем компьютере не запустить физически, они живут только в облаке Ollama. Дальше разберем, почему именно так и что делать, если…

2026/09/087 мин
📄 Статья

agent-browser от Vercel: токен эффективный браузер для AI агентов

agent-browser — это CLI-инструмент от Vercel Labs, который дает AI-агентам управлять браузером через команды терминала, а не через скриншоты. Вместо картинки страницы (3000-5000 токенов) агент получает текстовый ASCII-wireframe на 200-400 токенов и к…

2026/08/2610 мин
📄 Статья

Cline против OpenHands: что случилось с Roo Code и куда переходить в 2026

Roo Code закрылся 15 мая 2026 года: расширение для VS Code, облачный сервис Roo Code Cloud и Roo Code Router остановлены, репозиторий заархивирован в режиме read-only. Причина, которую команда назвала прямо: они больше не верят в IDE как будущее AI-к…

2026/08/188 мин