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

Есть два различных способа, которыми 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 обеспечивает API-сервер, совместимый с OpenAI шлюза и эндпоинт проверки здоровья. Это необязательно, если вы используете только чат-платформы (Telegram, Discord и т.д.), но обязательно, если вам нужна панель управления или внешние инструменты для доступа к шлюзу.

Примечание: API-сервер блокируется по API_SERVER_ENABLED=true. Чтобы открыть его за подключением 127.0.0.1 внутри контейнера, также установите API_SERVER_HOST=0.0.0.0 и API_SERVER_KEY (минимум 8 символов — сгенерируйте с помощью openssl rand -hex 32). Пример:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -e API_SERVER_ENABLED=true \
  -e API_SERVER_HOST=0.0.0.0 \
  -e API_SERVER_KEY=your_api_key_here \
  -e API_SERVER_CORS_ORIGINS='*' \
  nousresearch/hermes-agent gateway run

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

Запуск панели управления

Встроенная веб-панель управления работает как опциональный фоновый процесс внутри того же контейнера, что и шлюз. Установите 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 в фоновом режиме (работает от имени не-root пользователя hermes) перед выполнением основной команды через exec. Вывод панели управления имеет префикс [dashboard] в docker logs, что позволяет легко отделить его от журналов-шлюза.

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