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. sandstormd serves 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/deeplethesandstorm.svg)](https://yunodb.com/tools/deeplethesandstorm?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/deeplethesandstorm?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/deeplethesandstorm.svg" alt="Featured on YunoDB" height="20"></a>