Files
2026-06-28 22:41:16 +02:00

1.6 KiB

Hermes Docker Swarm stack

Deploy Hermes agent and gateway with GitHub Copilot and Telegram chat integration.

This stack uses the official Hermes Docker image from Nous Research: nousresearch/hermes-agent:latest.

The browser-accessible Hermes dashboard is published on host port 8087.

Usage

  1. Create Docker secrets for the required credentials:
docker secret create hermes_github_copilot_api_key /path/to/copilot-key.txt
docker secret create hermes_telegram_bot_token /path/to/telegram-bot-token.txt
docker secret create hermes_telegram_chat_id /path/to/chat-id.txt
docker secret create hermes_telegram_allow_from /path/to/telegram-allow-from.txt
  1. Create Docker secrets from the provided keys:
docker secret rm hermes_telegram_bot_token
docker secret rm hermes_telegram_chat_id
docker secret rm hermes_telegram_allow_from
docker secret rm hermes_github_copilot_api_key


echo -n '<TODO>' | docker secret create hermes_telegram_bot_token -
echo -n '<TODO>' | docker secret create hermes_telegram_chat_id -
echo -n '<TODO>' | docker secret create hermes_telegram_allow_from -
echo -n '<TODO>' | docker secret create hermes_github_copilot_api_key -
  1. Deploy the stack:
docker stack deploy -c stack-compose.yml hermes
  1. Verify services:
docker stack services hermes

Configuration

  • GITHUB_COPILOT_API_KEY is provided to both Hermes services via secret.
  • TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are provided via secrets.
  • hermes-gateway listens on port 8080 and connects to hermes-agent.
  • Replace the image references with your actual Hermes Agent and Gateway images if needed.