Find a file
2026-05-12 17:30:00 +02:00
compose Normalize runtime repository layout 2026-05-08 16:03:07 +02:00
docs Refactor UI to Operator Control Plane and add operator documentation 2026-05-12 17:30:00 +02:00
monitor-agent Add monitor agent version marker 2026-05-08 21:36:43 +02:00
node-agent Initial runtime multi-agent system snapshot 2026-05-08 11:53:16 +00:00
orchestrator Initial runtime multi-agent system snapshot 2026-05-08 11:53:16 +00:00
webui Refactor UI to Operator Control Plane and add operator documentation 2026-05-12 17:30:00 +02:00
.gitignore Normalize runtime repository layout 2026-05-08 16:03:07 +02:00
deploy.sh Add basic deployment helper 2026-05-08 19:49:25 +00:00
docker-compose.yml Initial runtime multi-agent system snapshot 2026-05-08 11:53:16 +00:00
README.md Normalize runtime repository layout 2026-05-08 16:03:07 +02:00

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