- docker-compose.yml: Ollama, Gitea, Agent worker, Monitor services - Dockerfile.agent: Hermes agent worker image with health endpoint - .env.example: Environment variable template - README.md: Setup instructions and service documentation Services include health checks, persistent volumes, isolated network, and proper dependency ordering.
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# 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 |