fleet-ops/README.md

# 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

```bash
# 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