# deeplethe/sandstorm

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/deeplethe-sandstorm).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

5,452 stars · 426 forks · Rust · Apache-2.0

## Links

- GitHub: https://github.com/deeplethe/sandstorm
- awesome-repositories: https://awesome-repositories.com/repository/deeplethe-sandstorm.md

## Topics

`agent-infrastructure` `ai-agents` `checkpoint-restore` `code-execution` `gvisor` `rust` `sandbox` `self-hosted` `snapshot`

## Description

Sandstorm is a self-hosted platform for running large numbers of isolated sandboxes for AI agents across a cluster of machines. A central master places sandboxes onto worker nodes, which join by pairing code or dial out from behind a NAT. Each node isolates workloads with either Firecracker microVMs or gVisor, a user-space kernel for hosts without KVM. Master, node, and web console roles ship in a single executable.

What sets it apart is density and start speed. Children are forked from a warmed parent snapshot using shared copy-on-write memory, so many sandboxes start in milliseconds without booting their own kernel. Idle sandboxes step down through running, frozen, checkpointed, and detached tiers, and a per-node gateway wakes a sleeping sandbox when a request arrives, so far more sandboxes can exist than could run at once. It also exposes an E2B-compatible control API so official E2B Python and JavaScript SDKs work against it unchanged, and an MCP tool server so assistants and editors can spawn, fork, and drive sandboxes.

Beyond that, the platform covers snapshots and branching (tag-based forking, incremental chains, live branching of a running sandbox, and portable archives), templates built from container images or prebuilt runtime recipes, and command execution and code evaluation inside sandboxes. Security controls include per-sandbox tokens, mutual TLS between cluster components, front-door TLS, and default-deny egress policies. Operators get a web admin console, one-command node enrollment, Prometheus metrics, audit logs, and load-testing and benchmarking tools for start latency and memory footprint. Python and TypeScript SDKs and a command-line tool are included, and a single installer script and systemd service files handle setup.

## Tags

### Artificial Intelligence & ML

- [MicroVM Agent Sandboxes](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-execution-sandboxes/microvm-agent-sandboxes.md) — Runs thousands of isolated AI agent sandboxes as microVMs on low-cost machines, with fast forking, snapshots, and idle-state tiering.
- [MCP Tool Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-tool-servers.md) — Serves MCP tools that spawn sandboxes, run commands, and evaluate code so assistants and editors can fork and drive microVMs.

### DevOps & Infrastructure

- [Tiered Sandbox Idle States](https://awesome-repositories.com/f/devops-infrastructure/idle-computer-suspension/tiered-sandbox-idle-states.md) — Steps idle sandboxes down through hot, frozen, checkpointed and detached tiers, so far more sandboxes can exist than could run at once. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/adr/README.md))
- [Tiered Idle Suspensions](https://awesome-repositories.com/f/devops-infrastructure/idle-resource-auto-shutdowns/tiered-idle-suspensions.md) — Steps idle sandboxes down through running, frozen, checkpointed, and detached tiers so far more sandboxes can exist than could run at once.
- [E2B-Compatible APIs](https://awesome-repositories.com/f/devops-infrastructure/managed-agent-sandboxes/e2b-compatible-apis.md) — Serves an E2B-compatible control API and per-sandbox hosts so official Python and JavaScript SDKs work by setting only a domain and key. ([source](https://github.com/deeplethe/sandstorm/blob/dev/CHANGELOG.md))
- [Master and Worker Node Orchestration](https://awesome-repositories.com/f/devops-infrastructure/master-and-worker-node-orchestration.md) — Keeps desired state on one master that places sandboxes onto worker nodes, which join by pairing code or dial out from behind a NAT.
- [MicroVM Orchestrators](https://awesome-repositories.com/f/devops-infrastructure/microvm-orchestrators.md) — Manages a multi-node cluster that places, forks, snapshots, and wakes Firecracker microVMs, with gVisor for hosts lacking KVM.
- [Sandbox Fleet Density Optimization](https://awesome-repositories.com/f/devops-infrastructure/sandbox-fleet-density-optimization.md) — Packs far more idle sandboxes onto cheap hardware by suspending them through tiers and waking them when traffic arrives.
- [Sandbox Forking](https://awesome-repositories.com/f/devops-infrastructure/sandboxing-environments/sandbox-forking.md) — Forks many isolated microVMs from one warmed parent snapshot with shared copy-on-write memory, so children start in milliseconds without booting a kernel. ([source](https://github.com/deeplethe/sandstorm/tree/v0.5.3))
- [Self-Hosted Sandbox Deployments](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-sandbox-deployments.md) — Lets official E2B SDKs and MCP-aware assistants target self-hosted sandbox infrastructure instead of the hosted service, with no code changes.
- [Wake on Incoming Traffic](https://awesome-repositories.com/f/devops-infrastructure/wake-on-incoming-traffic.md) — Detects requests for suspended sandboxes at the node gateway, restores them in a fraction of a second, pausing least-used ones to make room. ([source](https://github.com/deeplethe/sandstorm#readme))
- [Node-Judged Capacity Placement](https://awesome-repositories.com/f/devops-infrastructure/node-judged-capacity-placement.md) — Lets each node judge whether it can accept a new sandbox, keeping placement accurate without central load tracking. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/adr/README.md))
- [Wake-on-Request Gateways](https://awesome-repositories.com/f/devops-infrastructure/request-gateways/wake-on-request-gateways.md) — A per-node gateway intercepts requests for sleeping sandboxes, restores them from disk, and forwards the held request once ready.
- [Sandbox Backends](https://awesome-repositories.com/f/devops-infrastructure/sandbox-backends.md) — Supports interchangeable microVM and user-space isolation backends behind a common interface, running on KVM hosts and PVM-capable machines. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/adr/README.md))
- [Warm Snapshot Restores](https://awesome-repositories.com/f/devops-infrastructure/sandbox-lifecycle-management/snapshot-capture-and-restoration-managers/sandbox-disk-snapshots/warm-snapshot-restores.md) — Starts ready-to-use sandboxes in milliseconds by restoring warm templates and snapshots rather than cold-booting each machine.
- [Running Sandbox Checkpoints](https://awesome-repositories.com/f/devops-infrastructure/sandboxing-environments/sandbox-forking/running-sandbox-checkpoints.md) — Saves a running sandbox as a named tag that new sandboxes can fork from, while the original continues after a brief pause. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/API.md))
- [Single-Binary Deployments](https://awesome-repositories.com/f/devops-infrastructure/single-binary-deployments.md) — Packages master, node, and web console roles into one executable so a cluster needs only a single artifact to install. ([source](https://github.com/deeplethe/sandstorm#readme))
- [Template-Based Sandbox Launches](https://awesome-repositories.com/f/devops-infrastructure/template-based-sandbox-launches.md) — Starts one or many isolated sandboxes from a template or snapshot tag with placement, memory ceiling, volume and token options. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/API.md))
- [Warm Template Startups](https://awesome-repositories.com/f/devops-infrastructure/warm-template-startups.md) — Restores a snapshot of an already-started application instead of booting, so new sandboxes become ready in a fraction of the time. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/OPTIMIZATIONS.md))

### Operating Systems & Systems Programming

- [Snapshot Fork Restores](https://awesome-repositories.com/f/operating-systems-systems-programming/copy-on-write-memory-optimizations/snapshot-fork-restores.md) — Restores child sandboxes from a shared warmed snapshot with copy-on-write pages so many start in milliseconds without booting a kernel.
- [User-Space Kernel Isolation](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/sandboxing-isolation/user-space-kernel-isolation.md) — Isolates each sandbox inside a user-space kernel so low-cost hosts without hardware virtualization can still separate workloads. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/adr/README.md))

### Security & Cryptography

- [MicroVM Sandboxes](https://awesome-repositories.com/f/security-cryptography/application-and-system-security/sandbox-and-isolation/isolated-execution-sandboxes/microvm-sandboxes.md) — Runs every child as its own KVM-backed microVM with a separate network namespace, memory limit and reseeded randomness for multi-tenant safety. ([source](https://github.com/deeplethe/sandstorm/tree/v0.5.3))
- [Sandbox Egress Controls](https://awesome-repositories.com/f/security-cryptography/application-and-system-security/sandbox-and-isolation/isolated-execution-sandboxes/microvm-sandboxes/sandbox-network-security-controls/sandbox-egress-controls.md) — Blocks outside network access by default and lets operators set per-sandbox policies allowing the public internet or specific IPv4 addresses and CIDRs, with deny rules. ([source](https://github.com/deeplethe/sandstorm/blob/dev/CHANGELOG.md))
- [Mutual TLS Transport Encryption](https://awesome-repositories.com/f/security-cryptography/tls-traffic-encryption/mutual-tls-transport-encryption.md) — Encrypts and mutually authenticates all node-to-master traffic with certificates whichever side initiates, pins the master certificate in tokens, and supports node revocation. ([source](https://github.com/deeplethe/sandstorm/blob/dev/CHANGELOG.md))
- [Untrusted Code Sandboxes](https://awesome-repositories.com/f/security-cryptography/untrusted-code-sandboxes.md) — Runs untrusted or generated code in separate microVMs with locked-down networking, per-sandbox tokens, and mutual TLS between machines.

### Data & Databases

- [Snapshot Tag Forking](https://awesome-repositories.com/f/data-databases/backup-recovery/snapshot-tag-forking.md) — Creates child sandboxes from a saved tag, placing each on the least loaded compatible node and fetching the image from the source node when missing. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/API.md))

### Development Tools & Productivity

- [Sandbox Command Executions](https://awesome-repositories.com/f/development-tools-productivity/sandbox-command-executions.md) — Executes a command inside a running sandbox, waits up to a timeout, and returns standard output, standard error and exit code. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/API.md))
- [Python SDKs](https://awesome-repositories.com/f/development-tools-productivity/sdk-integrations/python-sdks.md) — Offers Python and TypeScript SDKs with matching options to create sandboxes, trust a private CA, wait until running, and call exec, eval, branch and touch. ([source](https://github.com/deeplethe/sandstorm/blob/dev/CHANGELOG.md))
- [MCP Client and Server Implementations](https://awesome-repositories.com/f/development-tools-productivity/vs-code-extensions/mcp-server-configurations/local-mcp-server-launches/mcp-client-and-server-implementations.md) — Serves an MCP tool server so assistants and editors can spawn, fork and drive sandboxes, run commands and evaluate code. ([source](https://github.com/deeplethe/sandstorm/tree/v0.5.3))

### Networking & Communication

- [Sandbox Port Gateways](https://awesome-repositories.com/f/networking-communication/sandbox-port-gateways.md) — Exposes any sandbox port through a node gateway that checks the sandbox token, streams bodies, supports WebSockets and refuses cold sandboxes. ([source](https://github.com/deeplethe/sandstorm/blob/dev/CHANGELOG.md))

### Software Engineering & Architecture

- [Pluggable Backends](https://awesome-repositories.com/f/software-engineering-architecture/pluggable-backends.md) — Isolates sandboxes through a common interface that can be backed by either a user-space kernel or a KVM microVM, chosen automatically or explicitly.

### System Administration & Monitoring

- [Frozen Sandbox Memory Reclamation](https://awesome-repositories.com/f/system-administration-monitoring/frozen-sandbox-memory-reclamation.md) — Moves cold pages of paused sandboxes into compressed in-memory swap, sharply cutting held memory while resumed sandboxes stay responsive. ([source](https://github.com/deeplethe/sandstorm/blob/dev/docs/OPTIMIZATIONS.md))

### Testing & Quality Assurance

- [Sandbox Start Latency Benchmarks](https://awesome-repositories.com/f/testing-quality-assurance/sandbox-start-latency-benchmarks.md) — Times each sandbox from the start call to its first successful web response, polling every few milliseconds, to report readiness speed. ([source](https://github.com/deeplethe/sandstorm/blob/dev/bench/baremetal/compare.py))
