BoxLite Cloud - BoxLite Documentation

The managed cloud for AI agents. Your agent gets compute, a filesystem that survives a restart, a public URL for whatever it builds, and hardware-level isolation around all of it — from a URL and an API key. You run no hosts, cache no images, and plan no capacity. A box starts in about a second, stops itself when it goes idle, and wakes when something reaches for it again. Cloud is not a separate client library. It is the same boxlite package you install locally, and the runtime handle is the only line that changes:

import os

from boxlite import ApiKeyCredential, Boxlite, BoxliteRestOptions

# The one line that differs from running BoxLite on your own machine.
rt = Boxlite.rest(
    BoxliteRestOptions(
        url=os.environ["BOXLITE_REST_URL"],  # https://api.boxlite.ai
        credential=ApiKeyCredential(os.environ["BOXLITE_API_KEY"]),
    )
)

Everything after that line — create, exec, volumes, tunnels — is the API you already know. The Quickstart has the whole first script, end to end.

Start here

Quickstart

Create a key, install the SDK, run your first command on Cloud.

Hand it to a coding agent

agent.md is a single file written for coding agents. Every code block in it is executed against the live API before release.

Cloud vs open source

Every difference between the hosted runtime and self-hosted BoxLite, in one table — plus how to port existing code.

Two shapes, one API

The same rt.create() call gives you either shape. What differs is how long the box lives.

A disposable box

Run untrusted or model-generated code, take the result, throw the box away. Hardware-level isolation without a virtualization host of your own.

A home for an agent

One box that keeps its filesystem, its packages, and its working state across sessions. The agent installs its tools once instead of rebuilding its world on every run.

The second shape is what a stateful microVM makes possible, and it is the part a plain sandbox API cannot do: an agent writes files, stops, and picks the work back up a week later.

Idle means no SDK, terminal, or preview traffic. Work running inside the box does not count, so a long unattended job can be stopped mid-run. Set the idle window per box — see Stop when idle.

What you get

Boxes

Shared Linux base images, three preset sizes, and a managed lifecycle. Up to 4 vCPU, 32 GiB memory, and 120 GiB storage per box.

Volumes

Managed storage that outlives the box that wrote it. Mount by a name you choose, and volumes are not metered at all.

Network

A tunnel to a port inside the box, carrying a public URL — so what your agent builds is reachable without you deploying it.

Pricing

Three metered rates and nothing else. Run wallet-only with no subscription, or take a plan whose quota covers usage first.

Concurrency is set by your plan — 20 boxes on Starter, 100 on Pro, 1000 on Max. See Wallet or a plan? for which one your usage argues for.

Build something

Six things people ship on Cloud, each a complete runnable guide:

Run Claude Code in a box

An autonomous coding agent with root inside its own kernel and nothing outside the box.

Code interpreter for an LLM

A model writes Python, it executes in a disposable box, the box is thrown away.

Review untrusted pull requests

Clone the PR into a box, run the suite, read the diff — with no access to your machine.

Data analysis agent

CSV in, model-written pandas analysis and a chart out.

Scrape the web safely

A browser box feeding clean data to a model, with parsing in a separate box.

A persistent shell per user

State survives stop and restart, so every user or branch keeps its own environment.

​Start here

Quickstart

Hand it to a coding agent

Cloud vs open source

​Two shapes, one API

A disposable box

A home for an agent

​What you get

Boxes

Volumes

Network

Pricing

​Build something

Run Claude Code in a box

Code interpreter for an LLM

Review untrusted pull requests

Data analysis agent

Scrape the web safely

A persistent shell per user

Start here

Two shapes, one API

What you get

Build something