Агент Гермеса — Докер

Существует два различных способа взаимодействия Docker с агентом Hermes:

1. Запуск Hermes в Docker — сам агент запускается внутри контейнера (основная тема этой страницы).
2. Docker как серверная часть терминала — агент запускается на вашем хосте, но выполняет каждую команду внутри одного постоянного контейнера песочницы Docker, который сохраняется при вызовах инструментов, /new и субагентах на протяжении всего процесса Hermes (см. Конфигурация → Docker Backend)

На этой странице описан вариант 1. Контейнер хранит все пользовательские данные (конфигурацию, ключи API, сеансы, навыки, воспоминания) в одном каталоге, смонтированном с хоста в /opt/data. Сам образ не имеет состояния и может быть обновлен путем получения новой версии без потери конфигурации.

Быстрый старт

Если вы впервые запускаете агент Hermes, создайте каталог данных на хосте и запустите контейнер в интерактивном режиме, чтобы запустить мастер установки:

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

Вы попадете в мастер установки, который запросит у вас ключи API и запишет их в ~/.hermes/.env. Вам нужно сделать это только один раз. На этом этапе настоятельно рекомендуется настроить систему чата для работы шлюза.

Работа в режиме шлюза

После настройки запустите контейнер в фоновом режиме в качестве постоянного шлюза (Telegram, Discord, Slack, WhatsApp и т. д.):

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Порт 8642 предоставляет доступ к OpenAI-совместимому API-серверу и конечной точке работоспособности шлюза. Это необязательно, если вы используете только платформы чата (Telegram, Discord и т. д.), но необходимо, если вы хотите, чтобы панель управления или внешние инструменты подключались к шлюзу.

Открытие любого порта на компьютере с выходом в Интернет представляет собой угрозу безопасности. Не следует этого делать, если вы не понимаете риски.

Запуск панели мониторинга

Встроенная веб-панель мониторинга работает как дополнительный побочный процесс внутри того же контейнера, что и шлюз. Установите HERMES_DASHBOARD=1 и откройте порт 9119 рядом с портом 8642 шлюза:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -p 9119:9119 \
  -e HERMES_DASHBOARD=1 \
  nousresearch/hermes-agent gateway run

Точка входа запускает hermes Dashboard в фоновом режиме (работает от имени пользователя hermes без полномочий root) перед выполнением основной команды. Вывод информационной панели имеет префикс «[dashboard]» в журналах Docker, поэтому его легко отделить от журналов шлюза.

Значение по умолчанию HERMES_DASHBOARD_HOST=0.0.0.0 требуется, чтобы хост мог получить доступ к информационной панели через опубликованный порт; В этом случае точка входа автоматически передает --insecure на hermes Dashboard. Переопределите значение «127.0.0.1», если вы хотите ограничить доступ к панели мониторинга только внутри контейнера (например, за обратным прокси-сервером в боковой панели).:::примечание Побочный процесс информационной панели не контролируется — в случае сбоя он остается неактивным до перезапуска контейнера. Запуск его как отдельного контейнера не поддерживается: для обнаружения активности шлюза панели мониторинга требуется общее пространство имен PID с процессом шлюза.