agent-system/README.md

755 B

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