Skip to main content
Create sandboxes, run commands in them, and move files in and out. Get an API key at sandbox.stateset.com.

Install

Initialize the Client

Create and Execute

File Operations

File content crosses the wire as base64 in both directions, as above — sending raw text writes the literal characters of your string rather than the bytes you meant.

Cleanup

A sandbox runs, and bills, until it is stopped or timeout_seconds expires. Stop it in a finally block so a thrown error does not leave one up:

Handling failures

execute resolves for a command that ran and failed — a non-zero exit is a result, not an exception. Check exit_code yourself; only transport and API errors reject.

Next steps

Sandbox quickstart

The wider flow, including REPL sessions and checkpoints.

API reference

Every endpoint this SDK wraps.

Python SDK

The same surface for Python services.

Security guide

What a sandboxed process can and cannot reach.
Last modified on August 31, 2026