# Agent System

Distributed multi-agent runtime for the homelab environment.

## Components

- orchestrator
- node-agent
- monitor-agent
- webui
- redis event bus

## Architecture

The system operates as a lightweight distributed orchestration layer across homelab nodes connected via Tailscale.

SATURN:
- development
- orchestration
- source of truth

SOLARIA:
- compute workloads
- GPU tasks
- inference

PIHA:
- infrastructure services
- Forgejo
- MQTT
- automation

VPS:
- public ingress
- edge services

## Development Flow

1. Develop on SATURN
2. Commit and push to Forgejo
3. Execution nodes pull updates
4. Containers redeploy via docker compose

## Runtime

Current runtime stack:
- Redis
- Orchestrator
- WebUI
- Monitor Agents
- Node Agents