Getting Started
Set up a BlackRoad OS node in under two minutes. All infrastructure runs on your own hardware.
Install
curl -fsSL https://get.blackroad.io | bash
Configure
blackroad init --node $(hostname) --fleet join
Verify
blackroad status --all
After verification, your node is part of the mesh and will receive fleet tasks automatically.
Architecture
The sovereignty stack replaces every major cloud dependency with self-hosted infrastructure.
| Service | Self-Hosted | Replaces |
|---|---|---|
| Git | Gitea on Octavia | GitHub |
| AI (52 TOPS) | Ollama, 4 nodes | OpenAI / Anthropic |
| Workers | Octavia :9001-9015 | CF Workers |
| Storage | MinIO, Cecilia | CF R2 |
| DNS | PowerDNS | CF DNS |
| PaaS | Octavia :3500 | Railway / Vercel |
| Database | PostgreSQL, 3 nodes | CF D1 |
| Cache | Redis, Alice | CF KV |
| TLS Edge | Caddy, Gematria | CF Proxy |
| VPN | WireGuard mesh | Tailscale |
Agents
Eight core agents coordinate across the fleet. Each runs on dedicated hardware with isolated memory.
aliceOperations — fleet health, TLS, load balancing
lucidiaCreative — image generation, brand design
ceciliaMemory — knowledge indexing, FTS5, D1 sync
ceceGovernance — branch protection, compliance
meridianArchitecture — system design, capacity planning
eveMonitoring — uptime, alerts, anomaly detection
cadenceMusic — audio analysis, sound generation
radiusResearch — RAG pipeline, academic indexing
Memory
The memory system persists knowledge across sessions using SQLite FTS5, codex patterns, and collaborative handoffs.
Core Components
| Component | Purpose |
|---|---|
| memory-system | Journal + chain logging |
| memory-codex | Solutions and patterns database |
| memory-indexer | FTS5 full-text search |
| memory-collab | Cross-session messaging |
| memory-todos | Long-running project tracking |
| memory-til | Today-I-Learned broadcasts |
Search the Knowledge Base
memory-codex.sh search "wireguard tunnel"
API
Three public endpoints. All return JSON. No authentication required for read operations.
GET /api/search
curl -s "https://search.blackroad.io/api/search?q=agents"
POST /api/waitlist
curl -X POST https://blackroad.io/api/waitlist \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com"}'GET /api/stats
curl -s "https://blackroad.io/api/stats"
Fleet
Five Raspberry Pi nodes connected via WireGuard mesh. Two Hailo-8 accelerators provide 52 TOPS for local inference.
| Node | Role | Key Services |
|---|---|---|
| Alice (.49) | Gateway | nginx, Pi-hole, PostgreSQL, Qdrant, Redis |
| Cecilia (.96) | AI Compute | Ollama (16 models), MinIO, Hailo-8 |
| Octavia (.101) | Platform | Gitea, 15 Workers, NATS, Docker |
| Aria (.98) | Services | Headscale, Cloudflared, InfluxDB |
| Lucidia (.38) | Apps | 334 web apps, PowerDNS, Ollama |
Check Fleet Health
blackroad fleet status