boxlite
BoxLite is an embeddable runtime for giving agents Linux execution environments backed by micro-VMs. Its Python SDK can manage OCI images, command execution and retained workspaces through application code. We tested the published 0.11.0 wheel on Apple Silicon macOS 26.6.2 with CPython 3.12.13, independently checking the wheel digest. The ARM64 Alpine image was pinned by manifest digest and reported version 3.22.8. Each box used one CPU and 256 MiB, with at most two running together. All runtime data and mounted files were artificial and explicitly placed outside the project.
Sixteen real checks passed. Commands preserved separate stdout, stderr and a nonzero exit code. Files survived separate executions and a second Python process reopening the same box ID. Read-only mounts refused writes, writable mounts returned output to the host, and an ordinary-directory copy round-trip preserved bytes. Two simultaneous commands kept distinct results. A short execution timeout returned exit code -15, after which another command succeeded. Outbound HTTP tests reversed their outcomes when we changed the running box allowlist between two public example domains.
The lifecycle and transfer boundaries matter in adoption. Default temporary boxes disappeared after stop, while retained boxes needed explicit removal. The high-level copy API refused a mounted /tmp destination; the tested transfer directory was /workspace. One initial registry-token connection failed before boot and a retry succeeded. File persistence is not a memory snapshot, and these checks do not certify adversarial containment, fleet scaling, every network protocol or another host platform. No model or cloud account was involved. Choose it when explicit workspace retention, mount permissions and command outcomes fit the intended agent workflow.
Read the full review, verification scope and sources →Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-06
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 11
- Latest release
- v0.12.0 (2026-11-06)
- Open issues
- 399
- Recent issues with at least one comment
- 2/30
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Who it fits
- You embed local Linux execution and need files to persist across agent callers.
- You can explicitly manage image acquisition, lifecycle, mounts and outbound policy.
- You require validated cross-platform fleet recovery or adversarial containment before adoption; this local test does not establish either.
- Your required workflow depends on this copy API writing directly into mounted guest paths.
Compatibility
Quick start
Use cases
Alternatives
Featured in these lists
Comments
No comments yet. Be the first!