ArgoBox Docs
Technical documentation for the ArgoBox infrastructure ecosystem
Admin Modules
2 docs-
Package Architecture (3-Tier Extraction)
How ArgoBox modules are extracted into reusable packages with a 3-tier architecture: types/core, adapters, and ArgoBox wiring.
-
Newsletter
Full newsletter platform: subscriber management, campaign composer with A/B testing, digest builder, templates, automations, analytics, and open/click tracking
AI & Automation
18 docs-
Content Studio
Internal authoring surface for posts and journals with voice authenticity scoring, RAG fact-checking, and AI-assisted drafting inside the Content Hub workflow
-
OpenClaw Security Model
Public trust model for running OpenClaw through ArgoBox instead of giving agents blind infrastructure access.
-
Argonaut Operator
Self-hosted operator AI lane with dual-mode deployment, RAG, memory, tools, multi-agent coordination, and admin UI
-
First Operator Loop
The first approval-backed workflow ArgoBox is trying to make trustworthy.
-
LiteLLM Gateway for ArgoBox
Use the <internal-host> OpenAI-compatible gateway for <internal-host> plus hosted providers.
-
MyVoice Studio
AI personality authoring platform — voice profiles, fact management, voice training lab, and instructions hub for authentic AI-generated content
-
Content Pipeline (Planned)
Automated conversation-to-content pipeline — scans AI conversations, auto-generates blog posts and journal entries with voice profile, queues for review
-
RAG Data Landscape
Complete map of all vault sources, embedding databases, model variants, and backup archives powering the four-tier RAG system
-
RAG Pipeline
Embedding generation, chunking strategy, hybrid search, SQLite storage, and admin management for the ArgoBox RAG system
-
Content Generation Pipeline
Voice profile-driven content generation, image creation, writing coaching, fact checking, and the full publish workflow
-
OpenClaw Engineering Operating System
The operating model for turning OpenClaw into a trustworthy autonomous engineering organization for ArgoBox
-
OpenClaw Sprint System
The sprint packet, kanban flow, and meeting contract OpenClaw should use for autonomous engineering work
-
AI Workbench & Forge Relay
AI coding workbench with 4 CLI tools, smart dispatcher, xterm.js terminals, Forge Relay API, and OpenClaw orchestration. Primary on a local LXC node, fallback on a remote VM.
-
OpenClaw Runtime Roster
Current-to-target role mapping for the canonical <internal-host> OpenClaw runtime
-
OpenClaw As The Hands Of The Collective
Defines OpenClaw as the execution layer of the daniel synthetic collective rather than the brain, planner, or governor
-
Hermes To OpenClaw Packet Contract
Defines the executable work packet that Hermes should hand to OpenClaw so the hands receive bounded intent instead of vague chat
-
Colorado Legal Intelligence Search
Real-time search across 1M+ Colorado law chunks with AI-powered answers, topic filters, and legal citations
-
RAG Embedding Auto-Detection
Automatic embedding model detection for RAG stores to prevent dimension mismatches
General
3 docs-
RAG System Architecture
Four-tier Retrieval-Augmented Generation system powering ArgoBox's AI search across all knowledge stores
-
OpenClaw Playground Monitoring System
Automated health checks and functional testing for ArgoBox playground labs
-
Bugs & Issues Tracker
Vault-synced bug tracking module for open-source release readiness.
General
5 docs-
Argo OS
Custom Gentoo Linux distribution for GPU compute and homelab workstations - archived, no longer maintained
-
Gentoo Build Swarm
Distributed Gentoo package compilation across Proxmox VMs - archived with Argo OS
-
APKG Package Manager
Custom package manager for Gentoo-based Argo OS - archived with Argo OS
-
Command Center
NOC-style fleet monitoring dashboard - superseded by ArgoBox admin dashboard
-
Homelab Infrastructure (Standalone)
Homelab infrastructure as a standalone project - merged into ArgoBox platform
Features
11 docs-
ArgoBox OS - Desktop Environment
A full desktop operating system in your browser with 38 built-in apps, 15 animated wallpapers, virtual desktops, AI copilot, and optional container backend
-
Command Palette
Ctrl+K command palette for fast admin navigation, content search, and workflow actions
-
Notification System
Global toast notification system with typed messages, progress tracking, auto-dismiss, and update-by-ID patterns
-
View Transitions
How Astro View Transitions work in ArgoBox — client-side navigation, astro:page-load vs DOMContentLoaded, and cleanup patterns
-
Search & Knowledge Graph
Search index generation, header search dropdown, configurable KnowledgeGraph visualization on /blog and /tags, MiniGraph on article pages, and admin settings for every visual parameter
-
Chat System
Multi-interface chat architecture — public widget, admin chat, Argonaut agent, demo chat, and user workbench with streaming, model selection, and conversation persistence
-
Knowledge Graph Obsidian Preset
One-click Obsidian demo preset, full-graph fit behavior, and admin persistence for ArgoBox's Tendril-powered graph
-
Status Pages
Public and admin status dashboards with 24-hour, 7-day, and 30-day uptime views, mode-based filtering, and incident timeline
-
Interactive Labs
Lab system architecture — LabLauncher provisioning, container/VM sessions, terminal and VNC access, challenge tracking, and dual-node failover
-
Blog & Journal: SSR Content Architecture
How ArgoBox serves 200+ blog posts and journal entries without hitting Cloudflare Worker limits — on-demand Gitea fetching, build-time metadata indexes, and marked rendering.
-
Newsletter Signup
Email newsletter subscription system with full campaign platform
Infrastructure
1 docsOverview
3 docs-
Welcome to ArgoBox
Overview of ArgoBox as a private AI control plane for homelabs, with the current public focus on one canonical stack.
-
Canonical Stack
The current ArgoBox v1 stack: ArgoBox, Hermes, OpenClaw, and Home Assistant.
-
Quickstart
Supported quickstart for the current ArgoBox homelab-first stack.
Playgrounds
6 docs-
Playgrounds Overview
Architecture and runtime breakdown of the ArgoBox public playground system -- real labs, live-data views, guided demos, session management, and verification
-
Container Labs
Terminal-based playground labs using ephemeral LXC containers -- containers, terminal, networking, and IaC labs with xterm.js access and guided challenges
-
Playground Runtime Classification
Current truth table for public playground modes -- real labs, live-data views, guided demos, and how to verify the deployed hub
-
VM and Advanced Labs
QEMU VM-based and AI-focused playground labs -- Argo OS graphical desktop via VNC, Ollama model operations, and RAG pipeline exercises
-
Guided And Live-Data Playgrounds
Client-side guided demos and telemetry-driven playground pages -- what is simulated, what reads live data, and what should not be called simulation
-
TerraTracer Playground
Interactive web app for converting bearing + distance sequences to GIS polygon maps with Leaflet.js visualization
Projects
10 docs-
ArgoBeat
Brainwave-inspired audio synthesis engine. Generate binaural beats, isochronic tones, and procedural soundscapes on-the-fly. Free, private, low-overhead delivery.
-
Command Center (status.argobox.com)
Live infrastructure dashboard powered by Flask, deployed on <internal-host> via Docker
-
Argo OS
Custom Gentoo Linux distribution running on <internal-host> with KDE Plasma 6, Hyprland, and a distributed build system
-
Tendril Knowledge Graph
Configurable, framework-agnostic knowledge graph engine with Cytoscape.js rendering, custom physics simulation, and full admin UI
-
APKG Package System
Custom Gentoo package management tool built to learn Portage from the inside out
-
Pentest Daemon
Penetration testing orchestration API running on three nodes (Sentinel VPS, <internal-host> Kali VM, <internal-host> Kali VM) with automatic failover, driven from the ArgoBox admin panel
-
TerraTracer
Geospatial tool for converting land certificates to precision GIS polygon maps using bearing + distance sequences
-
Career RAG System
Career-focused RAG vault for resume tailoring and job search optimization
-
Applyr Job Pipeline
Automated job application engine with AI vision form filling, watchdog self-recovery, candidate profiles, and multi-platform support
-
EdgeMail
Open-source serverless email platform for Cloudflare Workers — powers ArgoBox's email system
General
1 docsReference
2 docsSite Architecture
21 docs-
Tech Stack
Complete technology stack for ArgoBox including framework, styling, tooling, and dependency inventory
-
Pages & Routes
Complete inventory of all 400+ pages and routes in ArgoBox organized by category, rendering mode, and purpose
-
Layouts & Components
ArgoBox layout system, component library, and design system documentation
-
Content Collections
Astro content collection schemas, content backend abstraction, admin flags, and rendering pipeline
-
Middleware & Authentication
Request middleware pipeline, route-level auth enforcement, role system, and SEO handling
-
API Endpoints
Complete inventory of all API routes including auth, content management, AI, infrastructure proxies, and Argonaut endpoints
-
Auth: Network Lock Removal
Removal of IP-based network-lock authentication layer in favor of CF Access-only auth
-
User Portal
Internal documentation for authenticated user pages including the portal hub, access command center, unified dashboard, editor, workbench, and settings
-
Worker Size Optimization
How ArgoBox stays under Cloudflare's 3 MiB Worker size limit while running 130+ API routes
-
Ansible Section
Internal documentation for the Ansible sandbox, docs, and help pages covering template deployment, playbook reference, and step-by-step guides
-
F12 Console Audit
Automated browser console error detection across all ArgoBox pages
-
Mobile Responsiveness
Breakpoint strategy, grid system, touch targets, fullscreen embeds, and mobile-first patterns for the ArgoBox admin area
-
CSP & Security Headers
Content Security Policy configuration, security headers, and troubleshooting CSP violations on ArgoBox
-
About Page (formerly Services)
Three-lane page presenting ArgoBox as an open-source project: The Project, The daniel, The Community
-
Community Page
Community hub page with Discord, GitHub, and blog links plus build-in-public pillars and recent posts
-
Stories Page
Curated build logs from the lab — top 15 journal entries surfaced as /stories with featured hero and glassmorphic grid
-
Cost Analysis Page
Public showcase page comparing ArgoBox platform costs against AWS, Google Cloud, Azure, and Hetzner — portfolio case study for employers, clients, and community
-
Conversion Funnel
End-to-end conversion architecture connecting homepage hooks, /services lanes, /cost proof, and /community retention with cross-site CTAs across 6 pages
-
Infrastructure Explorer
Interactive force-directed graph playground visualizing the dual-galaxy network topology with Tendril, live metrics, and multi-layout controls
-
Site Revamp 2026-03
Search, Getting Started, and Playground Filters
-
Homepage & Navigation Revamp
Premium UX redesign of homepage hero, navigation, Getting Started page, and global typography