-
Notifications
You must be signed in to change notification settings - Fork 0
Update org profile README #42
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
blackboxprogramming
wants to merge
1
commit into
main
Choose a base branch
from
update-org-readme
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -1,38 +1,182 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| <div align="center"> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| # BlackRoad OS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| # ⚡ BlackRoad OS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| **Sovereign AI infrastructure built from bare metal up.** | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ### The Operating System for AI | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## The Stack | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Core platform powering 30,000+ AI agents, infrastructure mesh, and the BlackRoad developer ecosystem. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 790 MB of code across 229 repositories. 20+ languages. One person. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| [](https://blackroad.io) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| [](https://agents.blackroad.io) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| [](https://blackroad.io) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Python ............. 193 MB TypeScript ......... 187 MB | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| HTML ............... 150 MB Shell ............... 43 MB | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Go .................. 43 MB C / C++ ............. 27 MB | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| JavaScript .......... 22 MB Cuda / Metal ........ 1.8 MB | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| JavaScript .......... 22 MB Cuda / Metal ........ 1.8 MB | |
| JavaScript .......... 22 MB CUDA / Metal ........ 1.8 MB |
Comment on lines
+9
to
+19
Copilot
AI
Mar 9, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These exact size/repo-count metrics are likely to drift quickly and become incorrect. Consider making the numbers approximate (e.g., "~790 MB", "~229 repos"), adding an "as of" date, or generating this block from an automated script so the README stays accurate.
Copilot
AI
Mar 9, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Inconsistent hardware description: this line says "5 Raspberry Pi 5 nodes" but the architecture diagram below labels Alice as a "Pi 400". Update the wording here (or the diagram) so the node inventory matches.
Suggested change
| - **5 Raspberry Pi 5 nodes** -- Alice (gateway, Pi-hole, PostgreSQL, Qdrant), Cecilia (AI inference, TTS, MinIO, 16 Ollama models), Octavia (1TB NVMe, Gitea with 207 repos, Docker Swarm leader), Aria (Portainer, Headscale), Lucidia (334 web apps, FastAPI services, GitHub Actions runner) | |
| - **5 Raspberry Pi nodes** -- Alice (gateway, Pi-hole, PostgreSQL, Qdrant), Cecilia (AI inference, TTS, MinIO, 16 Ollama models), Octavia (1TB NVMe, Gitea with 207 repos, Docker Swarm leader), Aria (Portainer, Headscale), Lucidia (334 web apps, FastAPI services, GitHub Actions runner) |
Comment on lines
+49
to
+60
Copilot
AI
Mar 9, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This README includes very detailed production infrastructure and service inventory (node roles, specific tooling, counts of deployments/tunnels/domains/DBs). Since this is a public org profile, this level of operational detail can materially increase your attack surface. Consider removing or generalizing the specifics (e.g., omit exact counts and internal component lists) and/or moving the full inventory to a private/internal doc.
Suggested change
| - **remember** -- Long-term memory storage and retrieval (156K+ FTS5 entries, 228 SQLite databases) | |
| ### Infrastructure | |
| A 5-node Raspberry Pi cluster running production workloads, meshed with WireGuard, fronted by Cloudflare. | |
| - **5 Raspberry Pi 5 nodes** -- Alice (gateway, Pi-hole, PostgreSQL, Qdrant), Cecilia (AI inference, TTS, MinIO, 16 Ollama models), Octavia (1TB NVMe, Gitea with 207 repos, Docker Swarm leader), Aria (Portainer, Headscale), Lucidia (334 web apps, FastAPI services, GitHub Actions runner) | |
| - **2 DigitalOcean droplets** -- Headscale coordination, Nginx reverse proxy, WireGuard hub | |
| - **WireGuard mesh** -- Full mesh VPN across all nodes with automatic failover | |
| - **Cloudflare edge** -- 95+ Pages deployments, 18 tunnels, 48+ custom domains, 40 KV namespaces, 7 D1 databases, 10 R2 buckets | |
| - **Docker Swarm** -- Container orchestration across the cluster | |
| - **RoadNet** -- Custom carrier network with 5 Wi-Fi access points, per-node subnets, Pi-hole DNS | |
| - **remember** -- Long-term memory storage and retrieval across a large set of embedded databases | |
| ### Infrastructure | |
| A small self-hosted cluster running production workloads, meshed with a VPN overlay and fronted by a global edge network. | |
| - **On-prem cluster** -- ARM-based nodes hosting core services, storage, and internal tooling | |
| - **Cloud instances** -- Coordination, routing, and public entrypoints for the private network | |
| - **VPN mesh** -- Encrypted connectivity across all nodes with automated failover | |
| - **Edge network** -- CDN, serverless, and storage services for static assets and APIs | |
| - **Container orchestration** -- Distributed deployment and scaling for services | |
| - **RoadNet** -- Custom network with multiple access points, segmented subnets, DNS filtering |
Comment on lines
+130
to
+154
Copilot
AI
Mar 9, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The architecture diagram exposes internal hostnames and what look like IP last-octet identifiers (e.g., "Alice (.49)") plus detailed service placement. For a public org profile, consider sanitizing this to a higher-level diagram (no hostnames/IP hints; fewer service details) to reduce reconnaissance value.
Suggested change
| Cloudflare Edge | |
| (95 Pages, 18 tunnels, 48 domains) | |
| | | |
| +---------------+---------------+ | |
| | | | | |
| Alice (.49) Cecilia (.96) Octavia (.100) | |
| Pi 400 Pi 5 Pi 5 + 1TB NVMe | |
| Gateway AI Inference Gitea + Swarm | |
| Pi-hole 16 Ollama 207 repos | |
| PostgreSQL Hailo-8 Hailo-8 | |
| Qdrant TTS/MinIO NATS | |
| | | | | |
| +-------WireGuard Mesh----------+ | |
| | | | | |
| Aria (.98) Lucidia (.38) Mac (.28) | |
| Pi 5 Pi 5 Dev machine | |
| Portainer 334 web apps 400+ scripts | |
| Headscale FastAPI RoadC compiler | |
| GH Actions 228 SQLite DBs | |
| | | |
| +---------------+---------------+ | |
| | | | |
| gematria (DO) anastasia (DO) | |
| NYC3, 4cpu/8GB NYC1, WG hub | |
| WireGuard peer Headscale + Nginx | |
| Global Edge Layer | |
| (CDN, DNS, and secure tunnels) | |
| | | |
| +---------------+---------------+ | |
| | | | |
| On-Premise Cluster Cloud Cluster | |
| (Home / Lab) (Data Center) | |
| - Gateway & networking - Compute and storage | |
| - AI inference + tooling - Coordination services | |
| - Monitoring & observability- Ingress / API layer | |
| - Developer services | |
| | | |
| Developer Workstation | |
| (Primary build + IDE host) |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Minor grammar: "bare metal" is commonly hyphenated as the compound adjective "bare-metal" in this context.