Void-Box logo Void-Box
HomeDocsSecurityUpdatesContact GitHub

Documentation

Everything you need to evaluate, install, and operate Void-Box.

Getting Started

Overview What Void-Box is and how it works Getting Started Install Void-Box, define your first agent, and run it Installation Install Void-Box on Linux or macOS

Core Concepts

Architecture Component architecture, data flow, and system design Runtime Model Agent runtimes, provider mapping, and skill provisioning Security Model Defense in depth, seccomp, session auth, and guest hardening CLI and TUI Command reference, daemon API, and terminal UI Events and Observability Event types, OTLP traces, and metrics OCI Containers Guest images, base images, and OCI skills Snapshots Sub-second VM restore, snapshot types, and storage Host Mounts 9p and virtiofs host directory sharing

Guides

Running on Linux KVM setup, manual builds, mock mode, and testing Running on macOS Apple Silicon setup with Virtualization.framework Observability Setup OTLP configuration, Grafana playground, and telemetry AI Agent Sandboxing Isolated micro-VM agent execution patterns Pipeline Composition Multi-stage pipelines with pipe and fan-out YAML Specs Declarative run specifications Local LLMs with Ollama Ollama integration through guest-to-host networking

Reference

Wire Protocol vsock framing, message types, and protocol specification

© 2026 Void-Box — GitHub · Contact · RSS