sandbox0 0.2.2

Sandbox0 Python SDK

Sandbox0 Python SDK

The official Python SDK for Sandbox0, providing typed models and ergonomic high-level APIs for managing secure code execution sandboxes.

Installation

pip install sandbox0

Requirements

• Python 3.9 or later

Configuration

Environment Variable	Required	Default	Description
SANDBOX0_TOKEN	Yes	-	API authentication token
SANDBOX0_BASE_URL	No	https://api.sandbox0.ai	API base URL

Quick Start

import os
from sandbox0 import Client

client = Client(token=os.environ["SANDBOX0_TOKEN"])

# Using context manager for automatic cleanup
with client.sandboxes.open("default") as sandbox:
    # Execute Python code (REPL - stateful)
    result = sandbox.run("python", "print('Hello, Sandbox0!')")
    print(result.output_raw, end="")

Examples

Runnable examples are available in the examples/ directory:

Example	Description
01_hello_world	Basic sandbox usage
02_context_options	Context configuration options
03_files	File read/write/list operations
04_streaming	Streaming execution output
05_templates	Working with sandbox templates
06_volumes	Persistent volumes and snapshots
07_webhook	Webhook event delivery
08_network	Network policy configuration
09_expose_port	Exposing ports publicly

Run an example:

cd examples/01_hello_world
SANDBOX0_TOKEN=your-token python main.py

Bootstrap Mounts At Claim Time

from sandbox0.apispec.models.claim_mount_request import ClaimMountRequest
from sandbox0.apispec.models.create_sandbox_volume_request import CreateSandboxVolumeRequest

volume = client.volumes.create(CreateSandboxVolumeRequest())

sandbox = client.sandboxes.claim(
    "default",
    mounts=[
        ClaimMountRequest(
            sandboxvolume_id=volume.id,
            mount_point="/workspace/data",
        )
    ],
    wait_for_mounts=True,
    mount_wait_timeout_ms=45000,
)

for mount in sandbox.bootstrap_mounts:
    print(mount.sandboxvolume_id, mount.state)

Links

• Documentation
• API Reference
• GitHub Repository
• PyPI Package

License

Apache-2.0