Docker Compose HubDocker Compose Hub

Hermes-Agent

Hermes Agent is a self-hosted AI agent platform by Nous Research that enables you to run autonomous workflows, connect multiple AI providers, and manage intelligent task execution through a unified gateway and dashboard. It is designed for developers who want powerful AI automation with full control over infrastructure and data. This template includes: Hermes Gateway for running AI agent workflows and API integrations Web-based Dashboard for monitoring tasks and system health Persistent storage for agent data and configurations Support for API keys from providers like OpenAI and Anthropic Resource limits for stable and predictable performance Perfect for developers, researchers, and automation enthusiasts looking to self-host advanced AI agents, orchestration workflows, and LLM-powered services in a secure environment.

yaml

docker-compose.yml

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    ports:
      - "8642:8642"
    volumes:
      - ~/.hermes:/opt/data
    networks:
      - hermes-net
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: "2.0"
  dashboard:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-dashboard
    restart: unless-stopped
    command: dashboard --host 0.0.0.0
    ports:
      - "9119:9119"
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - GATEWAY_HEALTH_URL=http://hermes:8642
    networks:
      - hermes-net
    depends_on:
      - hermes
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: "0.5"
networks:
  hermes-net:
    driver: bridge

.ENV

.env example

# No environment variables detected

deployment

Quick Start

  1. Create a working directory named after the service.
  2. Copy the compose file and generated `.env` into that directory.
  3. Review the variables and replace placeholders with real values.
  4. Run `docker compose up -d`.
mkdir hermes-agent
cd hermes-agent
# create docker-compose.yml
# create .env
docker compose up -d