ArgoBox
ArgoBox Infrastructure & Automation
Connecting to Fleet...

⚡ Argo OS Build Swarm

Distributed Gentoo package compilation across 2 physical sites. Real-time coordination of build drones for parallel compilation.

66 Compute Cores
5 Build Drones
2 Orchestrators
1 Gateway
2 Sites
Fleet Status Build Activity Command Console

Fleet Status

Real-time status of build drones across both networks

🎛️ Orchestrators

🛰️
Orchestrator-Izar Primary
Milky Way Port 8080
Checking...
🛰️
Orchestrator-Tarn Standby
Andromeda Port 8080
Checking...

🌌 Milky Way Fleet Jove Network

🤖
Drone-Izar worker
Cores 16
CPU --%
RAM --%
Load --
Network -- MB/s
Current Task Idle
🤖
Drone-Tau-Beta worker
Cores 8
CPU --%
RAM --%
Load --
Network -- MB/s
Current Task Idle
🧹
Sweeper-Capella sweeper
Cores 8
CPU --%
RAM --%
Load --
Network -- MB/s
Current Task Idle

🌀 Andromeda Fleet Kronos Network

🤖
Drone-Tarn worker
Cores 14
CPU --%
RAM --%
Load --
Network -- MB/s
Current Task Idle
🤖
Drone-Meridian worker
Cores 20
CPU --%
RAM --%
Load --
Network -- MB/s
Current Task Idle

Build Activity

Real-time swarm status from the distributed build network

-- Completed
-- Building
-- Queued
-- Blocked
-- Speedup
Connecting to swarm... -- drones | -- cores
Loading drone status...
Session Started --
Wall Clock Time --
Total Build Time --
Speedup Factor --
⚠️ Blocked Packages 0
No blocked packages

Network Topology

Swarm architecture across Milky Way and Andromeda networks

Galactic Infrastructure

Two networks connected by Tailscale — a distributed Gentoo build civilization

Milky Way

Jove Network • 10.0.0.0/24
Arcturus-Prime
Altair-Lyra
Galileo-Outpost
Spica-Silo
STN-ALTAIR-001
⬡ Station Altair
API Gateway & Bridge
Altair-Lyra • Gateway
OPERATIONAL
PRIMARY
Icarus Jove Network • Primary
Drone-Icarus 16c
Drone-Tau-Ceti 8c
Sweeper-Galileo 8c
Tailscale Wormhole
WireGuard® Mesh VPN
--ms
Measuring...

Andromeda

Kronos Network • 192.168.50.0/24
Titawin-Host
Mirach-Maia-Silo
Caph-Silo
Matar-Silo
STANDBY
Titawin Kronos Network • Standby
Drone-Titawin 14c
Drone-Mirach 24c
70 Total Cores
5 Active Drones
2 Sites
-- Cross-Site Latency

Technical Architecture

Detailed system topology and build swarm infrastructure

Argo OS Build Swarm Architecture

A custom-built Gentoo package orchestration system — no distcc, no shared ccache. Each drone compiles full packages independently via SSH-dispatched tasks from a central orchestrator. Built entirely from scratch at gentoo-build-swarm, packages flow through queue → drone → binhost for binary installation.

Milky Way Cluster

Jove Network • 10.0.0.0/24
Nexus Gate
API Gateway • Relay Hub
Altair-Lyra • Gateway
Flask REST API providing unified access to swarm telemetry. Bridges both orchestrators via quantum mesh network.
Online
Icarus
Primary Orchestrator • LXC Container
Jove Network • Primary
Python service managing build queue. Tracks package dependencies, dispatches compile jobs to drones, monitors progress, handles failures.
Active
Build Drones
Drone-Icarus WORKER
16 cores 14GB Host: Arcturus-Prime
Jove Sector
Compiles full packages via SSH-dispatched emerge tasks
Drone-Tau-Ceti WORKER
8 cores 16GB Host: Arcturus-Prime
Jove Sector
Compiles full packages via SSH-dispatched emerge tasks
Sweeper-Galileo SWEEPER
8 cores 32GB Host: Galileo-Outpost
Jove Sector
Cleans build artifacts, handles local-only packages
Physical Infrastructure
Arcturus-Prime Proxmox VE Hypervisor
32 cores • 64GB RAM
Altair-Lyra Services Host (K3s)
8 cores • 16GB RAM
Galileo-Outpost Primary Workstation
16 cores • GPU Compute
Spica-Silo Local NAS Storage
32TB Raw
Tailscale
WireGuard® Mesh
-- ms
Zero-config NAT traversal End-to-end encryption Automatic key rotation

Andromeda Cluster

Kronos Network • 192.168.50.0/24
Titawin
Standby Orchestrator • VM
Kronos Network • Standby
Failover orchestrator syncing state from primary. Can assume control if primary becomes unavailable.
Standby
Build Drones
Drone-Titawin WORKER
14 cores 16GB Host: Titawin-Host
Kronos Sector
VM-based worker for heavy compilation tasks
Drone-Mirach WORKER
24 cores 32GB Host: Mirach-Maia-Silo
Kronos Sector
VM-based worker for heavy compilation tasks
Physical Infrastructure
Titawin-Host Proxmox VE Hypervisor
24 cores • 32GB RAM
Mirach-Maia-Silo Primary NAS + Media
120TB Raw • 8 cores
Caph-Silo Synology NAS
96TB Raw
Matar-Silo Backup Storage
24TB Raw

Build Flow

1
Package Request
User runs apkg install <package> or orchestrator detects missing dependency
→
2
Queue & Dispatch
Orchestrator adds to queue, selects available drone based on load and locality
→
3
Full Package Build
Drone compiles entire package via emerge — one package per drone, fully parallel
→
4
Binary Storage
Completed package uploaded to binhost (NFS share) for binary installation

Technology Stack

Gentoo Portage Package management & build system
SSH + Paramiko Secure task dispatch to drones
Python + Flask Orchestrator & Gateway APIs
Tailscale WireGuard-based mesh VPN
SSH Secure command dispatch to drones
NFS Shared binhost storage

Swarm Architecture

How the distributed build system works

🎛️

Orchestrators

Two orchestrators manage the build queue. The primary orchestrator (Icarus) delegates packages to drones. Titawin serves as standby for failover.

🤖

Build Drones

Five drones compile packages in parallel. Each drone pulls a package from the queue, compiles it, and reports results back to the orchestrator.

🔗

Gateway API

The gateway (Altair-Link) serves as the public API endpoint, aggregating status from all orchestrators and providing real-time fleet telemetry.

🧹

Sweeper Drone

A specialized drone (Sweeper-Galileo) handles cleanup tasks, dependency resolution, and background maintenance jobs.

Swarm CLI Commands

swarm status Show fleet status and active builds
swarm queue Display package queue statistics
swarm build <package> Queue a package for compilation
swarm logs Stream real-time build activity
Command Console Command Center Home Lab