# 57xx AI/Agents deploy artifacts

Copy these files to the target VMs per the [deployment task list](../../docs/02-architecture/AI_AGENTS_57XX_DEPLOYMENT_TASKS.md).

**VMID band:** 5700–5999 (see [VMID_ALLOCATION_FINAL.md](../../docs/02-architecture/VMID_ALLOCATION_FINAL.md)).

## Layout

| Path | Purpose |
|------|---------|
| **5704-state/** | Postgres + Redis for VM 5704. Copy `docker-compose.yml` and `.env.example` → `/opt/ai/state/`, rename `.env.example` to `.env`, set `POSTGRES_PASSWORD`. |
| **5702-inference/** | llama.cpp server for VM 5702. Copy `docker-compose.yml` → `/opt/ai/inference/`. Put GGUF at `/opt/ai/inference/data/models/model.gguf`. |
| **5703-agent/** | Agent worker for VM 5703. Copy `agent.py` → `/opt/ai/agent/config/`, `docker-compose.yml` and `.env.example` → `/opt/ai/agent/`. Rename `.env.example` to `.env`, set `MCP_URL`, `INF_URL`, and optionally `POOL_ADDRESS`. |

**5701 (MCP Hub)** is the **ai-mcp-pmm-controller** submodule at repo root; see [AI_AGENTS_57XX_DEPLOYMENT_TASKS.md](../../docs/02-architecture/AI_AGENTS_57XX_DEPLOYMENT_TASKS.md) Task 2.

## Optional: copy to /opt/ai (run on target host with repo at /opt/proxmox)

```bash
REPO=/opt/proxmox
sudo mkdir -p /opt/ai/state/data/postgres /opt/ai/state/data/redis
sudo mkdir -p /opt/ai/inference/data/models /opt/ai/agent/config /opt/ai/agent/logs
sudo chown -R $USER:$USER /opt/ai

cp "$REPO/scripts/57xx-deploy/5704-state/docker-compose.yml" /opt/ai/state/
cp "$REPO/scripts/57xx-deploy/5704-state/.env.example" /opt/ai/state/.env

cp "$REPO/scripts/57xx-deploy/5702-inference/docker-compose.yml" /opt/ai/inference/

cp "$REPO/scripts/57xx-deploy/5703-agent/agent.py" /opt/ai/agent/config/
cp "$REPO/scripts/57xx-deploy/5703-agent/docker-compose.yml" /opt/ai/agent/
cp "$REPO/scripts/57xx-deploy/5703-agent/.env.example" /opt/ai/agent/.env

# Edit secrets and URLs:
# - /opt/ai/state/.env  → POSTGRES_PASSWORD
# - /opt/ai/agent/.env  → MCP_URL, INF_URL, POOL_ADDRESS (if used)
```

Then start each stack from its directory (see [AI_AGENTS_57XX_DEPLOYMENT_TASKS.md](../../docs/02-architecture/AI_AGENTS_57XX_DEPLOYMENT_TASKS.md)).