Hermes Agent в Docker Compose: что подтверждено и как проверить запуск

Короткий ответ: что запускать

Если вы ищете готовую команду для Hermes Agent в Docker Compose, начните не с копирования случайного YAML, а с актуального docker-compose.yml из официального репозитория проекта. В переданных официальных материалах подтверждены Docker как способ установки, путь /opt/hermes/ внутри образа и каталог данных /opt/data/. Сам файл Compose в источнике упомянут, но его содержимое здесь не приведено. Поэтому имена сервисов, порты, переменные и секреты нужно брать из версии файла, которую вы собираетесь запускать.

Что подготовить

Подготовьте Linux, macOS, Windows или WSL2 с установленными Docker Engine и Docker Compose. Скачайте или склонируйте официальный репозиторий Hermes Agent, перейдите в каталог проекта и найдите docker-compose.yml. Для Windows в репозитории также заявлен отдельный docker-compose.windows.yml — выбирайте его только если он соответствует вашей среде и инструкции текущей версии. Не смешивайте файлы: Windows-вариант может иметь другую работу с путями и окружением.

Проверить конфигурацию до запуска

Перед запуском выполните универсальную проверку Compose из каталога с выбранным файлом:

docker compose config

Если файл называется иначе или лежит в другом месте, явно укажите его через -f. Команда должна вывести нормализованную конфигурацию без ошибок YAML и без отсутствующих обязательных переменных. Проверьте глазами, какие каталоги монтируются, какие порты публикуются, откуда берутся секреты и какая команда запускается. Конкретные имена этих параметров нельзя восстановить из переданных документов.

Запустить и посмотреть журналы

После успешной проверки запустите выбранную конфигурацию универсальной командой:

docker compose up -d

Если используется нестандартное имя файла, добавьте соответствующий -f. Затем посмотрите состояние и журналы:

docker compose ps
docker compose logs --follow

Ожидаемый результат на этом этапе — контейнер или контейнеры находятся в состоянии running, а в журналах нет циклического перезапуска, ошибок доступа к смонтированным каталогам или отсутствующих переменных. Название сервиса для адресного просмотра логов берите из самого Compose-файла, а не подставляйте наугад.

Сохранить настройки и сессии

В Docker-установке Hermes каталог данных обозначен как /opt/data/. Он должен быть связан с постоянным томом или каталогом хоста так, как предусмотрено официальным Compose-файлом. Это нужно проверить практически: запишите безопасное изменение конфигурации или создайте тестовую сессию, остановите проект, снова выполните docker compose up -d и убедитесь, что данные остались. Не удаляйте каталог данных для исправления обычной ошибки запуска: документация отдельно предупреждает не использовать удаление корня данных как способ ремонта установки.

Настроить модель и проверить диалог

Запущенный контейнер ещё не означает, что Hermes готов к диалогу. Официальный quickstart предлагает сначала настроить провайдера через hermes model или hermes setup, а затем выполнить обычный чат. В контейнере используйте способ входа, предусмотренный выбранным Compose-файлом и образом. Не помещайте ключи прямо в YAML, если проект предлагает отдельное хранилище или файл окружения. После настройки провайдера выполните проверочный запрос, например попросите кратко перечислить файлы тестового каталога. Успехом считается ответ без ошибки, а не только статус running.

Учебная проверка от входа до результата

Учебный пример: вход — актуальный официальный docker-compose.yml, файл окружения с нужными секретами и тестовый запрос «Покажи, что Hermes запущен, и ответь одним предложением». Обработка — docker compose config, затем docker compose up -d, просмотр docker compose ps и журналов, после чего выполняется настройка провайдера Hermes. Образец результата — контейнер остаётся в состоянии running, Hermes отвечает на запрос, а после остановки и повторного запуска сохранённые настройки доступны. Если ответ не получен, следующий шаг сотрудника — проверить журналы, имя модели, секрет провайдера и соответствие переменных актуальному Compose-файлу.

Ограничения и диагностика

Типовые ошибки разделяйте по уровню. Ошибка docker compose config обычно означает проблему YAML или переменных. Перезапуск контейнера указывает на команду запуска, доступ к каталогу или отсутствующий секрет — это видно в логах. Контейнер работает, но Hermes не отвечает, — проверьте провайдера, модель и авторизацию через команды настройки Hermes. Для диагностики самой установки документация рекомендует hermes doctor; для проблем с моделью — повторно запустить hermes model. Перед изменением томов и секретов сделайте резервную копию данных и сначала проверьте конфигурацию на тестовых данных.