Skip to main content
BoxLite’s how-to guides cover everything from building the project from source to integrating sandboxed execution into AI agent workflows. Each guide is self-contained and can be read independently.

​
All Guides

Building from Source

Clone the repository, install prerequisites, and build BoxLite for macOS or Linux using the provided Makefile targets and build scripts.

Examples Gallery

Browse nine comprehensive Python examples covering SimpleBox, CodeBox, BrowserBox, ComputerBox, lifecycle management, and more.

AI Agent Integration

Best practices for using BoxLite as a sandboxed execution environment for AI agents — configuration, concurrency, timeouts, security, and file transfer.

Image Registry Configuration

Configure BoxLite to pull OCI container images from custom registries, private enterprise registries, or local caching proxies.

macOS Sandbox Debugging

Debug macOS Seatbelt sandbox policy issues during development — real-time log monitoring, SBPL syntax, and common denial patterns.

​
Additional Topics

The source README also covers networking, volume mounting, debugging, resource tuning, deployment patterns, and integration examples. These topics are woven into the guides above and the Architecture and SDK Reference sections.
New to BoxLite? Start with the Getting Started guide first, then come back here for deeper topics.