@desplega.ai/agent-swarm 1.20.0 → 1.49.0

package/docker-compose.example.yml

@@ -7,10 +7,19 @@
 #  - Sets up an API service and multiple worker/lead agents
 #  - Deploys 2 worker agents and 1 lead agent by default
 #  - Uses volumes for persistent storage of logs, db and agent workspaces
+#
+# Port mapping:
+#  Each service uses its own host port variable (LEAD_PORT, WORKER1_PORT, etc.)
+#  to avoid conflicts when multiple services share the same host network.
+#  The variable names and defaults below are examples — adjust them to fit your
+#  setup, especially if you add more workers.
+#  In isolated environments where each container has its own network namespace,
+#  you may map all services to the same port (e.g. 3000:3000).
 
 services:
   api:
     image: "ghcr.io/desplega-ai/agent-swarm:latest"
+    platform: linux/amd64
     pull_policy: always
     stop_grace_period: 60s
 
@@ -42,6 +51,7 @@ services:
 
   lead:
     image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
     pull_policy: always
     stop_grace_period: 60s
 
@@ -57,6 +67,8 @@ services:
 
       # Important: Lead agent role
       - AGENT_ROLE=lead
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/lead
 
       # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
       # If in the same Docker network, use the service name
@@ -69,7 +81,7 @@ services:
       - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      - "${SERVICE_PORT:-3020}:3000"
+      - "${LEAD_PORT:-3020}:3000"
 
     volumes:
       - swarm_logs:/logs
@@ -80,6 +92,7 @@ services:
 
   worker-1:
     image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
     pull_policy: always
     stop_grace_period: 60s
 
@@ -93,6 +106,8 @@ services:
       # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
       - AGENT_ID=38d36438-58a0-45b5-8602-a5d52b07c2f1
       - AGENT_ROLE=worker
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/coder
 
       # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
       # If in the same Docker network, use the service name
@@ -105,7 +120,7 @@ services:
       - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      - "${SERVICE_PORT:-3021}:3000"
+      - "${WORKER1_PORT:-3021}:3000"
 
     volumes:
       - swarm_logs:/logs
@@ -116,6 +131,7 @@ services:
 
   worker-2:
     image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
     pull_policy: always
     stop_grace_period: 60s
 
@@ -129,6 +145,8 @@ services:
       # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
       - AGENT_ID=c1e2f3a4-5678-90ab-cdef-1234567890ab
       - AGENT_ROLE=worker
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/coder
 
       # - MCP_BASE_URL=${MCP_BASE_URL:-http://api:3013}
       # If in the same Docker network, use the service name
@@ -141,7 +159,7 @@ services:
       - SWARM_URL=${SWARM_URL:-localhost}
 
     ports:
-      - "${SERVICE_PORT:-3022}:3000"
+      - "${WORKER2_PORT:-3022}:3000"
 
     volumes:
       - swarm_logs:/logs
@@ -150,6 +168,173 @@ services:
 
     restart: unless-stopped
 
+  worker-content-writer:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      api:
+        condition: service_healthy
+
+    environment:
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
+      - AGENT_ID=322999d8-a1d0-4ae1-a6a0-5ba292d85720
+      - AGENT_ROLE=worker
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/content-writer
+      - MODEL_OVERRIDE=opus
+      - CAPABILITIES=core,task-pool,messaging,profiles,services,scheduling,epics,memory,content-writing
+
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
+
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+      - GITHUB_NAME=${GITHUB_NAME:-}
+      - SWARM_URL=${SWARM_URL:-localhost}
+
+    ports:
+      - "${CONTENT_WRITER_PORT:-3026}:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_content_writer:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-content-reviewer:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      api:
+        condition: service_healthy
+
+    environment:
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
+      - AGENT_ID=fc637423-24db-418a-ad03-a64e17c7b10a
+      - AGENT_ROLE=worker
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/content-reviewer
+      - MODEL_OVERRIDE=sonnet
+      - CAPABILITIES=core,task-pool,messaging,profiles,services,scheduling,epics,memory,content-review
+      # Content reviewer uses Gemini via OpenRouter
+      - HARNESS_PROVIDER=pi
+      - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
+
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
+
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+      - GITHUB_NAME=${GITHUB_NAME:-}
+      - SWARM_URL=${SWARM_URL:-localhost}
+
+    ports:
+      - "${CONTENT_REVIEWER_PORT:-3027}:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_content_reviewer:/workspace/personal
+
+    restart: unless-stopped
+
+  worker-content-strategist:
+    image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+    platform: linux/amd64
+    pull_policy: always
+    stop_grace_period: 60s
+
+    depends_on:
+      api:
+        condition: service_healthy
+
+    environment:
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
+      - AGENT_ID=7f95f57e-fff6-42fd-8e5b-cc345feab985
+      - AGENT_ROLE=worker
+      # Template for initial profile (fetched on first boot)
+      - TEMPLATE_ID=official/content-strategist
+      - MODEL_OVERRIDE=sonnet
+      - CAPABILITIES=core,task-pool,messaging,profiles,services,scheduling,epics,memory,content-strategy
+
+      # If in the same Docker network, use the service name
+      - MCP_BASE_URL=http://api:3013
+
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+      - GITHUB_NAME=${GITHUB_NAME:-}
+      - SWARM_URL=${SWARM_URL:-localhost}
+
+    ports:
+      - "${CONTENT_STRATEGIST_PORT:-3028}:3000"
+
+    volumes:
+      - swarm_logs:/logs
+      - swarm_shared:/workspace/shared
+      - swarm_content_strategist:/workspace/personal
+
+    restart: unless-stopped
+
+  # Example: Pi-mono worker (uses HARNESS_PROVIDER=pi instead of Claude)
+  # Uncomment to add a pi-mono powered worker to the swarm.
+  # Requires ANTHROPIC_API_KEY or OPENROUTER_API_KEY for authentication.
+  #
+  # pi-worker:
+  #   image: "ghcr.io/desplega-ai/agent-swarm-worker:latest"
+  #   platform: linux/amd64
+  #   pull_policy: always
+  #   stop_grace_period: 60s
+  #
+  #   depends_on:
+  #     api:
+  #       condition: service_healthy
+  #
+  #   environment:
+  #     - HARNESS_PROVIDER=pi
+  #     - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+  #     # Or use OpenRouter instead:
+  #     # - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
+  #     - API_KEY=${API_KEY}
+  #     # Replace by a valid UUID - IMPORTANT: Keep stable for task resume after restarts
+  #     - AGENT_ID=b2a3c4d5-6789-01ef-abcd-234567890abc
+  #     - AGENT_ROLE=worker
+  #
+  #     - MCP_BASE_URL=http://api:3013
+  #
+  #     - YOLO=true
+  #     - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+  #     - GITHUB_EMAIL=${GITHUB_EMAIL:-}
+  #     - GITHUB_NAME=${GITHUB_NAME:-}
+  #     - SWARM_URL=${SWARM_URL:-localhost}
+  #
+  #   ports:
+  #     - "${PI_WORKER_PORT:-3023}:3000"
+  #
+  #   volumes:
+  #     - swarm_logs:/logs
+  #     - swarm_shared:/workspace/shared
+  #     - swarm_pi_worker:/workspace/personal
+  #     # Persist pi-mono session files across restarts
+  #     - swarm_pi_agent:/home/worker/.pi/agent
+  #
+  #   restart: unless-stopped
+
 volumes:
   swarm_api:
   swarm_logs:
@@ -157,3 +342,9 @@ volumes:
   swarm_lead:
   swarm_worker_1:
   swarm_worker_2:
+  swarm_content_writer:
+  swarm_content_reviewer:
+  swarm_content_strategist:
+  # Uncomment if using the pi-worker service above
+  # swarm_pi_worker:
+  # swarm_pi_agent:

package/docker-compose.local.yml

@@ -0,0 +1,119 @@
+# Local development Docker Compose — builds from source
+#
+# Runs a minimal swarm: API + Claude lead + Pi-mono worker
+# Both agent services share the same worker image (only env vars differ).
+#
+# Prerequisites:
+#   .env must contain: API_KEY, CLAUDE_CODE_OAUTH_TOKEN, OPENROUTER_API_KEY
+#   Optionally set PI_MODEL to override the pi-mono model (default: openrouter/anthropic/claude-sonnet-4)
+#   Or use ANTHROPIC_API_KEY instead of OPENROUTER_API_KEY (comment swap in pi-worker env)
+#
+# Usage:
+#   docker compose -f docker-compose.local.yml up --build
+#   docker compose -f docker-compose.local.yml down
+
+services:
+  api:
+    container_name: swarm-api
+    platform: linux/amd64
+    build:
+      context: .
+      dockerfile: Dockerfile
+    stop_grace_period: 60s
+
+    environment:
+      - API_KEY=${API_KEY}
+      - SLACK_DISABLE=true
+      - GITHUB_DISABLE=true
+
+    ports:
+      - "3013:3013"
+
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://localhost:3013/health || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 15s
+
+    restart: unless-stopped
+
+  lead:
+    container_name: swarm-lead
+    platform: linux/amd64
+    image: swarm-worker:local
+    build:
+      context: .
+      dockerfile: Dockerfile.worker
+    stop_grace_period: 60s
+
+    depends_on:
+      api:
+        condition: service_healthy
+
+    environment:
+      - CLAUDE_CODE_OAUTH_TOKEN=${CLAUDE_CODE_OAUTH_TOKEN}
+      - API_KEY=${API_KEY}
+      - AGENT_ID=23b94e8e-4fd3-465c-b525-1bcb050bb214
+      - AGENT_ROLE=lead
+      - MCP_BASE_URL=http://api:3013
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-dev@localhost}
+      - GITHUB_NAME=${GITHUB_NAME:-Lead Agent}
+
+    ports:
+      - "3020:3000"
+
+    volumes:
+      - local_logs:/logs
+      - local_shared:/workspace/shared
+      - local_lead:/workspace/personal
+
+    restart: unless-stopped
+
+  pi-worker:
+    container_name: swarm-pi-worker
+    platform: linux/amd64
+    image: swarm-worker:local
+    build:
+      context: .
+      dockerfile: Dockerfile.worker
+    depends_on:
+      api:
+        condition: service_healthy
+    stop_grace_period: 60s
+
+    environment:
+      - HARNESS_PROVIDER=pi
+      - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
+      # Model for pi-mono via OpenRouter (required — pi-mono has no default for OpenRouter)
+      - MODEL_OVERRIDE=${PI_MODEL:-openrouter/anthropic/claude-sonnet-4}
+      # Or use Anthropic directly (no MODEL_OVERRIDE needed, defaults to opus):
+      # - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+      - API_KEY=${API_KEY}
+      - AGENT_ID=cfecf31f-d3bb-4a5b-ab29-43bc49082031
+      - AGENT_ROLE=worker
+      - MCP_BASE_URL=http://api:3013
+      - YOLO=true
+      - GITHUB_TOKEN=${GITHUB_TOKEN:-}
+      - GITHUB_EMAIL=${GITHUB_EMAIL:-dev@localhost}
+      - GITHUB_NAME=${GITHUB_NAME:-Pi Worker}
+
+    ports:
+      - "3021:3000"
+
+    volumes:
+      - local_logs:/logs
+      - local_shared:/workspace/shared
+      - local_pi_worker:/workspace/personal
+      - local_pi_agent:/home/worker/.pi/agent
+
+    restart: unless-stopped
+
+volumes:
+  local_logs:
+  local_shared:
+  local_lead:
+  local_pi_worker:
+  local_pi_agent: