homelab-codex-ws/services/agent-system/README.md

Agent System

Central runtime materializer and Operator Control Plane UI.

Components

• Redis: Central state store (on PIHA).
• Runtime Materializer: Converts Redis state to JSON files in /opt/homelab/world.
• Web UI: Exposes API endpoints and serving the Operator UI.

Deployment (on PIHA)

cd services/agent-system
./deploy.sh

Deployment (on CHELSTY)

cd services/stability-agent
docker compose up -d --build

Verification

The deploy.sh script automatically verifies the local endpoints. You can also manually check:

# Check runtime summary
curl http://localhost:18180/summary

# Check discovered nodes
curl http://localhost:18180/nodes

# Check discovered services
curl http://localhost:18180/services

Directory Structure

• /opt/homelab/world: Contains materialized JSON state.
• /opt/homelab/state: Contains operator configuration and local heartbeats.