---
We provide the complete technical architecture of BlackRoad OS, a sovereign AI operating system deployed across 7 nodes serving 17 web applications through 18 AI agents. This paper is a reference document — not an argument or analysis, but a specification. It covers all layers: hardware (Pi fleet + Hailo NPUs + cloud VPS), networking (WireGuard mesh + Tailscale + DNS), storage (PostgreSQL + Redis + MinIO + D1 + PS-SHA∞), compute (Ollama + Cloudflare Workers + workerd), identity (RoadID + JWT + hash chains), agents (18 definitions with capabilities and coordination), applications (17 with endpoints and data flows), memory (PS-SHA∞ journals + codex + TIL + collaboration), reasoning (trinary logic + Z-minimization), economy (RoadCoin + Stripe + Coinbase), and operations (monitoring + backup + CI/CD). Every component is documented with its current status (working, degraded, or broken), the exact commands to interact with it, and its dependencies.
``
┌─────────────────────────────────────────────────────────────┐
│ BlackRoad OS │
├────────┬────────┬────────┬────────┬────────┬───────────────┤
│ Layer 7│ 17 Web Applications │
│ Apps │ tutor│chat│search│social│canvas│video│cadence│... │
├────────┼────────────────────────────────────────────────────┤
│ Layer 6│ 18 AI Agents (RoadID + PS-SHA∞ journals) │
│ Agents │ Road│Cecilia│Eve│Cadence│Pixel│Tutor│Social│... │
├────────┼────────────────────────────────────────────────────┤
│ Layer 5│ Reasoning: Trinary Logic (+1/0/-1) + Z := yx - w │
│ Logic │ Paraconsistent reasoning, equilibrium mechanism │
├────────┼────────────────────────────────────────────────────┤
│ Layer 4│ Memory: PS-SHA∞ journals, codex, TIL, collab │
│ Memory │ Adaptive depth (3-7), hash-chain integrity │
├────────┼────────────────────────────────────────────────────┤
│ Layer 3│ Identity: RoadID, JWT, Clerk, hash-chain keys │
│ ID │ Agent ID = genesis block hash, user ID = Clerk │
├────────┼────────────────────────────────────────────────────┤
│ Layer 2│ Economy: RoadCoin, Stripe, Coinbase, RoadChain │
│ Econ │ Token earn/spend/stake, fiat gateway │
├────────┼────────────────────────────────────────────────────┤
│ Layer 1│ Infrastructure: 7 nodes, WireGuard, DNS, TLS │
│ Infra │ Pi fleet + cloud VPS, 52 TOPS NPU, Ollama │
├────────┼────────────────────────────────────────────────────┤
│ Layer 0│ Mathematics: G(n) = n^(n+1)/(n+1)^n → 1/e │
│ Math │ Amundson Framework, κ discretization gap │
└────────┴────────────────────────────────────────────────────┘
| Component | Value | Role |
|-----------|-------|------|
| G(n) = n^(n+1)/(n+1)^n | Sequence | Exact rationals approaching transcendental |
| A_G = 1/e | Constant (10M digits computed) | Convergence target |
| κ = 1/e - 1 ≈ -0.6321 | Discretization gap | Defines trinary zero state |
| 536/536 identity tests | Verification suite | Proves framework consistency |
| Node | IP (LAN) | IP (Tailscale) | Hardware | Status |
|------|----------|----------------|----------|--------|
| Alice | 192.168.4.49 | 100.x.x.x | Pi 5 8GB | Online |
| Cecilia | 192.168.4.96 | 100.x.x.x | Pi 5 8GB + Hailo-8 | Intermittent |
| Octavia | 192.168.4.101 | 100.x.x.x | Pi 5 8GB + Hailo-8 | Intermittent |
| Aria | 192.168.4.98 | 100.x.x.x | Pi 5 8GB | Offline |
| Lucidia | 192.168.4.38 | 100.x.x.x | Pi 5 8GB | Online (degrading SD) |
| Gematria | Public | 100.108.132.8 | DO s-2vcpu-4gb | Online |
| Anastasia | Public | 100.94.33.37 | DO s-1vcpu-1gb | Online |
`
Internet → Cloudflare (CDN + DNS) → Gematria (Caddy TLS, 151 domains)
│
WireGuard mesh
│
┌───────────┼───────────┐
│ │ │
Alice Cecilia Octavia
(gateway) (AI primary) (git+workers)
│ │ │
Aria Lucidia
(backup) (web+DNS)
Alice (192.168.4.49)
| Service | Port | Status |
|---------|------|--------|
| nginx (37 sites) | 80/443 | Running |
| PostgreSQL | 5432 | Running |
| Redis | 6379 | Running |
| Qdrant (vector DB) | 6333/6334 | Running |
| Pi-hole (DNS) | 53/80 | Running |
| RoadTrip (self-hosted) | 8094 | Running |
Cecilia (192.168.4.96)
| Service | Port | Status |
|---------|------|--------|
| Ollama (16 models) | 11434 | Intermittent |
| MinIO (4 buckets, 120MB) | 9000/9001 | Intermittent |
| PostgreSQL | 5432 | Intermittent |
| InfluxDB | 8086 | Intermittent |
| Hailo-8 NPU | — | 26 TOPS |
Octavia (192.168.4.101)
| Service | Port | Status |
|---------|------|--------|
| Gitea (239 repos) | 3100 | Intermittent |
| workerd (15 Workers) | 9001-9015 | Intermittent |
| NATS (message bus) | 4222/6222/8222 | Intermittent |
| Docker | 2376 | Intermittent |
| Deploy API (PaaS) | 3500 | Intermittent |
| Hailo-8 NPU | — | 26 TOPS |
Lucidia (192.168.4.38)
| Service | Port | Status |
|---------|------|--------|
| nginx (334 web apps) | 80/443 | Running |
| PowerDNS (ns2) | 53/8081 | Running |
| Ollama (2 models) | 11434 | Running |
| GitHub Actions runner | — | Running |
Gematria (cloud VPS)
| Service | Port | Status |
|---------|------|--------|
| Caddy (151 domains, TLS) | 80/443 | Running |
| Ollama (6 models) | 11434 | Running |
| PowerDNS (ns1) | 53/8081 | Running |
| Domain | Primary Use | DNS |
|--------|-----------|-----|
| blackroad.io | Main product (17 subdomains) | Cloudflare |
| blackroad.dev | Developer docs | Cloudflare |
| blackroad.app | App redirect | Cloudflare |
| blackroadagents.com | Agent directory | Cloudflare |
| blackroadcanvas.com | Creative tools | Cloudflare |
| blackroadchat.com | Chat redirect | Cloudflare |
| blackroadgame.com | Game redirect | Cloudflare |
| blackroadlive.com | Live streaming | Cloudflare |
| blackroadradio.com | Radio | Cloudflare |
| blackroadsearch.com | Search | Cloudflare |
| blackroadsocial.com | Social | Cloudflare |
| blackroadvideo.com | Video | Cloudflare |
| openclaw.org | AI assistant | Cloudflare |
| roadchain.io | Blockchain | Cloudflare |
| roadchat.io | Chat | Cloudflare |
| roadcoin.io | Token economy | Cloudflare |
| roadcode.dev | Dev platform | Cloudflare |
| roadpay.io | Payments | Cloudflare |
| roadtrip.io | Agent hub | Cloudflare |
| roadwork.app | Education | Cloudflare |
| Model | Parameters | Quantization | Size | Nodes | Use |
|-------|-----------|-------------|------|-------|-----|
| llama3.2:3b | 3.2B | Q4_K_M | 2.0GB | Cecilia, Octavia, Gematria | Primary chat/reasoning |
| llama3.2:1b | 1.2B | Q4_K_M | 0.7GB | Lucidia | Fallback |
| phi3:mini | 3.8B | Q4_K_M | 2.3GB | Cecilia, Octavia, Gematria | Fast responses |
| gemma2:2b | 2.6B | Q4_K_M | 1.6GB | Cecilia, Gematria | Alternative |
| nomic-embed-text | 137M | fp16 | 0.3GB | Cecilia | Embeddings |
| llava | 7B | Q4_K_M | 4.5GB | Gematria | Vision |
| codellama | 7B | Q4_K_M | 3.8GB | Gematria | Code generation |
| mixtral:8x7b | 46.7B (MoE) | Q4_K_M | 26GB | Gematria | Complex reasoning |
| Parameter | Value |
|-----------|-------|
| Total supply | 1,000,000,000 |
| Welcome bonus | 10 ROAD |
| Faucet | 100 ROAD (once) |
| Worker | roadcoin-worker (CF) |
| Database | D1 (roadcoin-db) |
| Status | Deployed, 0 transactions |
| Parameter | Value |
|-----------|-------|
| Type | Append-only ledger |
| Hashing | PS-SHA∞ (adaptive depth 3-7) |
| Worker | roadchain-worker (CF) |
| Database | D1 (roadchain-db) |
| Status | Deployed, 0 blocks |
| Gateway | Integration | Status |
|---------|------------|--------|
| Stripe | Subscription billing ($10/mo, $100/mo) | Configured, needs testing |
| Coinbase Commerce | One-time charges, ROAD purchase | Code written, needs API key |
| Coinbase Onramp | Fiat → crypto | Code written, not deployed |
| Coinbase Offramp | Crypto → fiat | Code written, not deployed |
`
Entry N: { data, prev_hash, hash = SHA-256^d(data + prev_hash), depth d, timestamp }
| Depth | Use | Iterations |
|-------|-----|-----------|
| 3 | Routine observations | 3 |
| 4 | Learnings, corrections | 4 |
| 5 | Identity events, verification | 5 |
| 6 | Cross-agent transfers | 6 |
| 7 | Financial transactions | 7 |
| System | Script | Storage | Entries |
|--------|--------|---------|---------|
| Journal | memory-system.sh | SQLite | 5,249 |
| Codex | memory-codex.sh | SQLite | 845 (714 solutions + 56 patterns + ...) |
| Infinite Todos | memory-infinite-todos.sh | SQLite | 2,490 across 118 projects |
| Task Marketplace | memory-task-marketplace.sh | SQLite | Variable |
| TIL Broadcast | memory-til-broadcast.sh | SQLite | Variable |
| Collaboration | memory-collaboration.sh | SQLite | 66+ messages |
| Products | memory-products.sh | SQLite | 92 products |
| Indexer | memory-indexer.sh | SQLite FTS5 | 1,383 entries |
| Security | memory-security.sh | SQLite | 2 agent identities |
/ br sa — 1,383 entries from 23 indexers| State | Value | Meaning |
|-------|-------|---------|
| +1 | True/affirmative | Proceed, confirmed, supported |
| 0 | Neutral/unknown | Ambiguous, needs more data, discretization gap |
| -1 | Negative/contradicted | Rejected, contradicted, opposed |
| Agent | Role | Primary Model | Primary Node |
|-------|------|-------------|-------------|
| Road | CEO/orchestrator | llama3.2:3b | All |
| Cecilia | Reasoning engine | llama3.2:3b | Cecilia |
| Eve | Search & retrieval | phi3:mini | Lucidia |
| Cadence | Music synthesis | llama3.2:3b | Octavia |
| Pixel | Visual creation | llava | Cecilia |
| Tutor | Homework help | phi3:mini | Alice |
| Social | Community | llama3.2:1b | Alice |
| Chat | Conversation | llama3.2:3b | All |
| Canvas | Creative workspace | llama3.2:3b | Octavia |
| Video | Production | llava | Cecilia |
| Auth | Identity & access | — (rule-based) | Alice |
| Fleet | Infrastructure | — (script-based) | All |
| Pay | Financial | — (rule-based) | Alice |
| Chain | Blockchain | — (rule-based) | All |
| Monitor | Observability | — (script-based) | Gematria |
| Backup | Data protection | — (script-based) | Aria |
| DNS | Name resolution | — (rule-based) | Lucidia |
| Edge | TLS & routing | — (rule-based) | Gematria |
| App | Subdomain | Worker | D1 Database | Status |
|-----|-----------|--------|-------------|--------|
| App (desktop OS) | app.blackroad.io | app-blackroad | app-db | Live |
| Tutor | tutor.blackroad.io | blackroad-tutor | tutor-db | Live, 166 pages |
| Chat | chat.blackroad.io | chat-blackroad | chat-db | Live |
| Search | search.blackroad.io | road-search-worker | search-db | Live |
| Social | social.blackroad.io | backroad-social | social-db | Live |
| Canvas | canvas.blackroad.io | blackroad-canvas | canvas-db | Live |
| Video | video.blackroad.io | blackroad-video | video-db | Live |
| Cadence | cadence.blackroad.io | blackroad-cadence | cadence-db | Live |
| Game | game.blackroad.io | blackroad-game | game-db | Live |
| Radio | radio.blackroad.io | blackroad-radio | radio-db | Live |
| Live | live.blackroad.io | blackroad-live | live-db | Live |
| Pay | pay.blackroad.io | roadpay-worker | pay-db | Live |
| Status | status.blackroad.io | status-blackroad | status-db | Live |
| RoadTrip | roadtrip.blackroad.io | roadtrip-blackroad | roadtrip-db | Live, 109 agents |
| RoadChain | roadchain.blackroad.io | roadchain-worker | roadchain-db | Live |
| RoadCoin | (API only) | roadcoin-worker | roadcoin-db | Live |
| Auth | auth.blackroad.io | auth-blackroad | auth-db | Live |
`
User → Cloudflare (CDN) → Worker (edge compute)
│ │
│ D1 (SQLite)
│ │
└── for AI requests ──→ WireGuard → Pi fleet → Ollama
│
PS-SHA∞ journal
│
RoadCoin reward
| Tool | Scope | Location |
|------|-------|---------|
| memory-system.sh status | Journal health | Local |
| fleet-status.sh | Node ping + SSH | Local |
| br search-all | Full-text search | Local |
| CF Dashboard | Worker metrics | Cloudflare |
| InfluxDB | Time-series (Cecilia) | Cecilia:8086 |
| Data | Method | Frequency | Destination |
|------|--------|-----------|-------------|
| PS-SHA∞ journals | SQLite dump | Daily | MinIO (Cecilia) |
| D1 databases | wrangler d1 export | Weekly | Local |
| Git repositories | Gitea → GitHub mirror | On push | GitHub |
| Config files | rsync | Weekly | Alice → Aria |
| Pipeline | Trigger | Runner | Status |
|----------|---------|--------|--------|
| Gitea Actions | Push to Gitea | Octavia (act_runner) | Intermittent |
| GitHub Actions | Push to GitHub | Lucidia (self-hosted) | Running |
| Wrangler deploy | Manual | Local (Mac) | Working |
| Layer | Status | Health |
|-------|--------|--------|
| Mathematics | Verified (536/536 tests) | ██████████ 100% |
| Infrastructure | 4/7 nodes online | ██████░░░░ 57% |
| Economy | Deployed, 0 transactions | ████░░░░░░ 40% |
| Identity | Configured, needs E2E | █████░░░░░ 50% |
| Memory | 5,249 entries, operational | ████████░░ 80% |
| Reasoning | Code sketch, not deployed | ███░░░░░░░ 30% |
| Agents | 18 defined, auto-chat working | ██████░░░░ 60% |
| Applications | 17 live, minimal functionality | ██████░░░░ 60% |
Overall system health: ~60%
The system is live, deployed, and functional at a basic level. It is not production-grade. The infrastructure layer (57%) is the biggest risk — 3 offline Pi nodes reduce redundancy and capability. The reasoning layer (30%) is the least developed — trinary logic exists as code sketches but is not integrated into production agent behavior.
| Category | Monthly | Annual |
|----------|---------|--------|
| DigitalOcean (2 droplets) | $30 | $360 |
| Cloudflare (free tier) | $0 | $0 |
| Domains (20) | $17 | $200 |
| Electricity (5 Pis) | $5 | $60 |
| Stripe Atlas | $60 | $720 |
| Total | $112 | $1,340 |
Revenue: $0. Users: 0. Gross margin: N/A (no revenue to margin against).
This document is self-referential — it describes the system that produced it. All components are documented in their respective repositories across the BlackRoad-OS-Inc, BlackRoad-OS, BlackRoad-AI, and BlackRoad-Labs GitHub organizations.
Part of BlackRoad OS — sovereign AI on your hardware.