fleet-ops

Sovereign Fleet Operations: Ansible playbooks and infrastructure-as-code for the Wizard fleet.

Quick Start (Docker Compose)

Prerequisites

• Docker and Docker Compose v2 installed
• (Optional) NVIDIA GPU + nvidia-container-toolkit for GPU-accelerated inference

Setup

# Clone and enter the repo
git clone <repo-url> && cd fleet-ops

# Copy the env template and edit it
cp .env.example .env
# Edit .env with your actual values (API keys, ports, agent name, etc.)

# Start all services
docker compose up -d

# View logs
docker compose logs -f agent

# Stop everything
docker compose down

Services

Service	Description	Default Port
ollama	Local LLM inference engine	11434
gitea	Forge (git hosting, issue tracker)	3000, 2222
agent	Hermes agent worker loop	8080
monitor	Health check reporter	(internal)

Customization

• Edit .env to change ports, agent name, loop interval, and log level.
• Edit docker-compose.yml to add/remove services or adjust resource limits.
• Place agent source code in an agent/ directory before building.

Files

• docker-compose.yml — Main compose configuration
• Dockerfile.agent — Agent worker image
• .env.example — Environment variable template
• playbooks/ — Ansible playbooks for VPS baseline configuration