Skip to content

blackboxprogramming/BlackRoad-Operating-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

533 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlackRoad OS

Self-hosted edge AI operating system running 52 TOPS of inference on Raspberry Pi clusters.

What is BlackRoad OS?

BlackRoad OS is a sovereign computing platform that runs AI inference, networking, and automation entirely on hardware you own. No cloud dependencies. No API keys expiring at 2am. Five Raspberry Pi 5 nodes connected by a WireGuard mesh network, accelerated by dual Hailo-8 NPUs, running 16 local models through Ollama.

The fleet self-heals. Cron-driven watchdogs monitor every service, restart what dies, and log what broke. Cloudflare tunnels route 48+ domains through the cluster. Docker Swarm orchestrates containers across nodes. Gitea hosts 200+ repositories on a 1TB NVMe.

This is infrastructure that runs in a closet and serves production traffic.

Infrastructure

Node Role Hardware
Alice Gateway, DNS, ingress Pi 400, Pi-hole, PostgreSQL, Qdrant, 65+ tunnel routes
Cecilia AI inference, TTS Pi 5, Hailo-8 (26 TOPS), 16 Ollama models, MinIO
Octavia Git, orchestration Pi 5, Hailo-8 (26 TOPS), 1TB NVMe, Gitea, Docker Swarm leader
Aria Container management Pi 5, Portainer, Headscale
Lucidia Apps, CI/CD Pi 5, GitHub Actions runner, FastAPI, 334 web apps

Network: WireGuard mesh (10.8.0.x) with Anastasia (DigitalOcean) as hub. RoadNet WiFi overlay across all nodes.

Stack

Component What it does
Hailo-8 52 TOPS combined neural network inference (2x 26 TOPS)
Ollama 16 local LLMs including 4 custom CECE models
WireGuard Encrypted mesh VPN across all nodes + cloud
Pi-hole Fleet-wide DNS filtering and custom zones
Docker Swarm Container orchestration across the cluster
Gitea Self-hosted Git with 207 repositories
NATS Lightweight messaging between services
RoadC Custom programming language with Python-style indentation
Cloudflare 18 tunnels, 48+ domains, D1/KV/R2 storage

Read More

Articles on building and running this infrastructure:

Links

License

Copyright 2026 BlackRoad OS, Inc. — Alexa Amundson. All rights reserved.

Related Projects

Project Description
BlackRoad AI Dashboard Real-time AI fleet monitoring dashboard
BlackRoad Desktop App Electron app for fleet management
BlackRoad Chrome Extension Browser extension for fleet monitoring
Fleet Heartbeat Distributed health monitoring system
Lucidia Autonomous AI agent with persistent memory
Hailo Vision Computer vision with Hailo-8 AI accelerators

About

Self-hosted edge AI operating system | 52 TOPS on Raspberry Pi clusters | Hailo-8 + Ollama + WireGuard mesh

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors