AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
LLM Infra/
boxlite
boxlite logo

boxlite

Active·★ 2.7k·Apache-2.0·Updated 2026-11-21

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 →

Hands-on tested · Tested on 2026-11-06 with Python SDK 0.11.0; release commit 24cef4607416b4b75e4663f966f8315a5e4773bd; hash-verified macOS ARM64 wheel; pinned Alpine ARM64 manifest.

Setup: Apple Silicon macOS 26.6.2, CPython 3.12.13; actual Linux ARM64 micro-VMs with Alpine 3.22.8, 1 CPU/256 MiB each; disposable runtime and synthetic mounts

Commands run

<venv>/bin/python doc/review-fixtures/boxlite-runtime-20261106/verify.py --workdir <disposable-parent> --output /tmp/boxlite-results.json

What we saw

  • Sixteen real runtime checks passed; a new Python process reopened the same box ID and recovered retained files. Default temporary-box cleanup and explicit retained-box removal passed.
  • Exit 7 kept stdout/stderr; a 0.25-second timeout returned -15 and later execution worked. Copying via /workspace round-tripped; mounted /tmp was explicitly refused.
  • Read-only and writable binds behaved as configured. Reversing a live allowlist reversed fresh HTTP outcomes. An earlier registry-token connection failed; retry succeeded. No model, fleet or comprehensive containment audit.

Data as of 2026-11-20.

License
Apache-2.0
Latest release
v0.14.1 · 2026-11-19
Last commit
2026-11-19
Contributors
48
Forks
248
Open issues and PRs
551
First published
2025-12-07
npm package
@boxlite-ai/boxlite 0.14.1 · 14,314 downloads last week
PyPI package
boxlite 0.14.1

Source: GitHub, npm and PyPI public APIs.

#agent-framework#agentic#ai-agent#embedded#rust#sandbox#security#self-hosted
$ Install
$ pip install boxlite
↗ Visit site★ GitHub
01

Features

01Persistent micro-VM environments for OCI images.
02Embeddable SDKs with CLI and optional server mode.
03Configurable network egress and resource limits.
02

Why choose it

+The same box and files recovered through a separate Python process in real micro-VM execution.
+Explicit exit results, working directories, file transfer and selected mount permissions supported inspectable execution.
+Live allowlist changes reversed fresh HTTP connection outcomes without recreating the box.
03

Trade-offs

!Temporary boxes delete by default; retained workspaces require an explicit lifecycle and cleanup.
!High-level file copying refuses mounted paths such as /tmp; choose a suitable transfer directory.
!Image acquisition is an external dependency; an initial public registry connection failed in this test.
05

Maintenance check

ActiveChecked: 2026-11-06
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
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 38, 53, 24, 11, 25, 55, 21, 19, 39, 35, 29, 53

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.

04

Who it fits

Pick it if
  • You embed local Linux execution and need files to persist across agent callers.
  • You can explicitly manage image acquisition, lifecycle, mounts and outbound policy.
Look elsewhere if
  • 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.
06

Compatibility

macos
Apple Silicon, macOS 12+
Verified via docs
linux
Linux x86_64 / ARM64 with KVM
Verified via docs
windows
WSL2 x86_64 with KVM
Verified via docs
07

Quick start

1
$ pip install boxlite
08

Use cases

↳Give an agent an isolated code-execution environment.
↳Preserve installed tools and files across task turns.
↳Embed execution environments into an agent service.
09

Alternatives

⚡Top VS:
VSchidori★1.4k→VSos-moda★122→VSokou★1.2k→VSAReaL★5.9k→
chidori logo
chidori★ 1.4k
The agent framework where every run is durable, replayable, and resumable by default.
VSCompare→
os-moda logo
os-moda★ 122
Your server fixes itself at 3am. You sleep. AI-native operating system built on NixOS.
VSCompare→
okou logo
okou★ 1.2k
Okou connects to the tools your team already uses and does the work — across marketing, sales, engineering, and operations, under your control.
VSCompare→
AReaL logo
AReaL★ 5.9k
The RL Bridge for LLM-based Agent Applications. Made Simple & Flexible.
VSCompare→
hermes-agent logo
hermes-agent★ 265.2k
The agent that grows with you
VSCompare→
ODS logo
ODS★ 7.9k
ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
VSCompare→
yomo logo
yomo★ 1.9k
🦖 Serverless AI Agent Framework with Geo-distributed Edge AI Infra.
VSCompare→
ppt-master logo
ppt-master★ 79.1k
AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
See all alternatives →

Featured in these lists

  • Best Open-Source AI Agent Sandboxes and Code Execution Runtimes

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06Compatibility07Quick start08Use cases09Alternatives
boxlite-ai /
boxlite
↗

Persistent Linux micro-VMs with explicit execution and network control

2.7k248Apache-2.0
Last commit1d ago
StatusActive
CategoryLLM Infra
Contributors48
Latest releasev0.14.1
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.