Sandbox SDK

Give your agents the real world, safely.

Isolated cloud containers for AI agents. Create, execute, stream — from TypeScript or CLI. Sub-second provisioning, any Docker image, zero DevOps.

$ npm install @tangle-network/sandbox

Documentation Join Waitlist

sandbox — streaming

const box = await client.create({ image: 'node:22' });

// Stream an AI agent task in real-time
for await (const event of box.streamTask(
  'Refactor src/ to TypeScript and add tests'
)) {
  if (event.type === 'tool_call')
    console.log(`Using: ${event.tool}`);
  if (event.type === 'message')
    process.stdout.write(event.content);
}

✓ 12 files converted  · 47 tests passing
✓ PR #18 created      · src/ → TypeScript

See It Work

SDK and CLI. Full control.

Every example uses the real @tangle-network/sandbox API.

From zero to running in seconds.

Create an isolated container from any Docker image, execute shell commands, and get structured results. Full root access, custom environment variables, optional SSH.

→Any Docker image works

→Full root access

→Structured stdout/stderr/exit code

→Sub-200ms exec latency

tangle sandbox

$ tangle sandbox create \
  --name my-project \
  --image node:20 \
  --ssh

sandbox-sdk v0.4.0
Provisioning sandbox...
  ✓ Sandbox created sbx_a8f3c2d1  ·  region: us-east  ·  2.8s

$ tangle sandbox exec sbx_a8f3c2d1 \
  "npm install && npm test"

  added 847 packages in 12s
  Tests: 42 passed, 0 failed
  ✓ exit code 0

What You Get

A full computer for every agent.

Not a REPL. Not a function. A real Linux environment with filesystem, networking, tools, and root access.

without sandbox

$ agent.run("refactor to TypeScript")
 → reading files...
 ✗ ENOENT: no filesystem access
$ agent.run("install and test")
 → npm install...
 ✗ EPERM: cannot execute binaries
$ agent.run("complex migration")
 ✗ TIMEOUT: killed after 30s
3 tasks attempted · 0 succeeded

with sandbox

$ box.task("refactor to TypeScript")
 → 23 files converted
 ✓ done (18s)
$ box.exec("npm install && npm test")
 → 847 packages, 47 tests
 ✓ all passing (12s)
$ box.task("create PR with changes")
 ✓ PR #18 created (3s)
3 tasks · 3 succeeded · 33s total

Learn more

Frequently Asked Questions

What is the Sandbox SDK?

The Sandbox SDK lets you create isolated cloud containers for AI agents via a TypeScript SDK or CLI. Each sandbox is a full Linux environment with root access, SSH, file system operations, and optional GPU support — provisioned in seconds.

What AI backends are supported?

Sandboxes support multiple agent backends: OpenCode (multi-provider, default), Claude Code (Anthropic-native), Codex (OpenAI-native), AMP (Sourcegraph), and Factory Droids. You can also bring your own API key and switch backends per request.

What languages and runtimes work?

Any Docker image works — Node.js, Python, Rust, Go, Ubuntu, or your own custom Dockerfile. Pre-built images are available for common stacks like Ethereum, Solana, and ML workloads. GPU images with CUDA support are available for inference and training.

How does snapshot and restore work?

You can checkpoint the full state of any sandbox — filesystem, installed packages, everything. Restore instantly to create new sandboxes from that state. Bring your own S3-compatible storage (AWS S3, GCS, Cloudflare R2) for snapshot persistence.

Cloud containers for AI agents.

Create your first sandbox, run an agent, stream results. One npm install.

Get Started