Initial commit: BlackRoad Garage infrastructure documentation

- README.md: Fleet overview and quick access commands
- FLEET.md: Complete device specifications and inventory
- NETWORK.md: IP addresses, Tailscale mesh, network diagram
- SSH_CONFIG.md: SSH configuration reference
- HAILO.md: Hailo-8 AI accelerator documentation

Fleet: 8 devices, 52 TOPS AI compute, 167 Docker containers

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Your Name
2026-02-09 15:53:26 -06:00
commit 8469a27ec1
5 changed files with 477 additions and 0 deletions

50
README.md Normal file
View File

@@ -0,0 +1,50 @@
# BlackRoad Garage
Private infrastructure documentation for the BlackRoad fleet.
## Fleet Overview
```
┌─────────────────────────────────────────────────────────────────────┐
│ BLACKROAD INFRASTRUCTURE │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 👤 HUMAN IN THE LOOP │
│ └── alexandria (Mac) ─── Control Center │
│ │
│ 🤖 AI COMPUTE (Hailo-8) │
│ ├── octavia (Pi 5) ─── 26 TOPS │
│ └── cecilia (Pi 5) ─── 26 TOPS │
│ │
│ 🖥️ COMPUTE CLUSTER │
│ ├── alice (Pi 4) ─── Headscale mesh server │
│ ├── lucidia (Pi 4) ─── 15 containers │
│ └── aria (Pi 5) ─── 142 containers │
│ │
│ ☁️ CLOUD │
│ ├── codex-infinity (DO) ─── 8GB/4vCPU │
│ └── shellfish (DO) ─── 1GB/1vCPU │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
## Quick Access
```bash
# SSH Commands
ssh alexandria # Your Mac
ssh octavia # AI Node 1 (Hailo-8)
ssh cecilia # AI Node 2 (Hailo-8)
ssh alice # Pi cluster
ssh lucidia # Pi cluster
ssh aria # Pi cluster (142 containers!)
ssh codex-infinity # DigitalOcean
ssh shellfish # DigitalOcean
```
## Documentation
- [Fleet Inventory](./FLEET.md) - Complete device specifications
- [Network Map](./NETWORK.md) - IPs, Tailscale, ports
- [SSH Config](./SSH_CONFIG.md) - SSH configuration reference
- [Hailo Setup](./HAILO.md) - AI accelerator documentation