Documentation
Everything you need to understand, operate, and extend halo-ai. Every doc links to its tutorial.
Getting Started
Installation
One command, under 5 minutes. The installer detects your hardware and configures everything. Read the docs | Watch the tutorial
Free Website
Host a multilingual website for $13/yr. Hugo + Cloudflare Pages. The full recipe. Read the guide | Watch the tutorial
Core Documentation
Architecture
The full system architecture: 33 services, 27 agents, inter-service communication, and hardware abstraction layers. Read the docs
Services
Individual service documentation covering configuration, dependencies, ports, and health checks. Read the docs
Security
Threat model, network isolation, authentication. Nothing leaves your hardware unless you tell it to. Read the docs | Watch the tutorial | View the audit
Troubleshooting
Common issues, diagnostic commands, log locations, and recovery procedures. Read the docs
Infrastructure
Kansas City Shuffle — SSH Ring Bus
Wire up the mesh. Every machine talks to every other machine. Bidirectional, resilient, no single point of failure. Read the docs | Watch the tutorial
GlusterFS Replicated Storage
Combine drives across machines into one pool. Data exists on every node. Watch the tutorial
VPN
Secure remote access. Mesh networking between machines without exposing ports. Read the docs
Stack Protection
Freeze, thaw, rollback. Survive Arch Linux rolling updates. Compiled from source, protected by snapshots. Read the docs
AI & Voice
Voice Platform
Clone any voice in 30 seconds. Whisper STT, Voxtral understanding, Kokoro TTS. Full pipeline. Read more | Watch the tutorial
Image Generation
ComfyUI with SDXL and Flux. 123.5GB VRAM on AMD Strix Halo. Watch the tutorial
Agents
27 autonomous agents. Meet the family. Read more | Read the docs
Community
Discord Bots
7 bots, 24/7, every language. Deploy the family in one command. Watch the tutorial
Game Servers
Pick a game, deploy it, players connect to home.halo-ai.ca. Watch the tutorial
Advanced
Blueprints
Declarative service definitions for extending halo-ai. Read the docs
Autonomous Pipeline
How agents coordinate without human intervention. Read the docs
Security Audit
Full public audit — every finding, every fix, every firewall rule. No more secrets. Read the audit
Designed and built by the architect.
-
Mar 31, 2026
How to Host a Website for Free — The halo-ai Way
Complete guide to hosting a multilingual website with zero cost. Hugo + Cloudflare Pages + Namecheap. No hosting fees, no servers, no middlemen.
-
Mar 31, 2026
Security Audit — 2026-03-31
Full security audit of the halo-ai infrastructure. No more secrets.