Find a file
2026-05-12 18:48:35 +02:00
.junie/memory Resolve merge conflicts 2026-05-12 17:34:42 +02:00
docs Integrate operator control plane with live homelab runtime 2026-05-12 18:48:35 +02:00
hosts Resolve merge conflicts 2026-05-12 17:34:42 +02:00
webui Integrate operator control plane with live homelab runtime 2026-05-12 18:48:35 +02:00
.gitignore Add tmp/ to .gitignore and remove from index 2026-05-12 18:02:37 +02:00
deploy.sh Add basic deployment helper 2026-05-08 19:49:25 +00:00
docker-compose.yml Integrate operator control plane with live homelab runtime 2026-05-12 18:48:35 +02: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