sandstorm
Run thousands of AI agent sandboxes on the cheapest machines.
What is sandstorm?
Run thousands of AI agent sandboxes on the cheapest machines.
Overview of sandstorm
What it is
Sandstorm is a system for running thousands of AI agent sandboxes on a single machine or a fleet of machines. It pauses idle sandboxes and snapshots them to disk, then restores them quickly when a request arrives. This allows one machine to hold far more sandboxes than it could run simultaneously. It supports two sandbox backends: gVisor containers and Firecracker microVMs. Each sandbox has its own network namespace. The master node provides a web console for viewing and managing sandboxes and scheduling across the fleet.
Key features
- One master, many nodes. The master keeps desired state in SQLite and places sandboxes. Nodes join by address and pairing code, or dial out from behind NAT.
- Wake on traffic. A gateway on the sandbox's node wakes it and forwards the request.
- Node self-protection. Nodes refuse new work when memory runs low, so SSH stays reachable.
- One binary.
sandstormdserves as the master, node, and web console. - Tuned for each backend. gVisor and Firecracker each get their own optimizations.
Use cases
Sandstorm is designed for running AI agents that spend much of their time waiting. It enables running thousands of such agent sandboxes on the cheapest machines, efficiently managing resources by suspending idle sandboxes and restoring them on demand.
Getting started
Requirements: Linux with cgroup v2, runsc on the PATH, Rust, and Node 22.12 or later for the console. bash git clone https://github.com/deeplethe/sandstorm.git && cd sandstorm npm --prefix web/console ci && npm --prefix web/console run build cargo build --release -p sandstorm-core sudo ./target/release/sandstormd serve --master --node Open the console at https://127.0.0.1:8080, past the browser's warning about its private CA, sign in with the token in /var/lib/sandstorm/pki/api-token, make a template with + From an image, and start a sandbox from it. For a fleet of machines, see the repository README for scripts/fleet.sh commands.
License and pricing
Licensed under Apache-2.0. Open source.
Based on the project's public README and repository metadata.