curl -X POST https://api.sandbox.stateset.app/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Your",
    "last_name": "Name",
    "organization_name": "Your Company",
    "email": "you@company.com",
    "password": "YourSecurePassword123!"
  }'

export STATESET_API_KEY="sk-sandbox-YOUR_API_KEY"

npm install @stateset/sandbox-sdk

pip install stateset-sandbox

import { Sandbox } from '@stateset/sandbox-sdk';

const sandbox = await Sandbox.create();

const result = await sandbox.exec('echo "Hello from Stateset!"');
console.log(result.stdout); // Hello from Stateset!

await sandbox.close();

from stateset_sandbox import Sandbox

with Sandbox.create() as sandbox:
    result = sandbox.exec('echo "Hello from Stateset!"')
    print(result.stdout)  # Hello from Stateset!

# Create a sandbox
SANDBOX_ID=$(curl -s -X POST https://api.sandbox.stateset.app/api/v1/sandbox \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout_seconds": 300}' | jq -r '.sandbox_id')

# Execute a command
curl -s -X POST "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/execute" \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command": "echo Hello from Stateset!"}' | jq .

# Clean up
curl -s -X POST "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/stop" \
  -H "Authorization: Bearer $STATESET_API_KEY"

import { Sandbox } from '@stateset/sandbox-sdk';

const sandbox = await Sandbox.create();

// Write a file
await sandbox.writeFile('/workspace/hello.py', 'print("Hello world!")');

// Run it
const result = await sandbox.exec('python /workspace/hello.py');
console.log(result.stdout); // Hello world!

// Read it back
const content = await sandbox.readFile('/workspace/hello.py');
console.log(content); // print("Hello world!")

await sandbox.close();

from stateset_sandbox import Sandbox

with Sandbox.create() as sandbox:
    sandbox.write_file("/workspace/hello.py", 'print("Hello world!")')
    result = sandbox.exec("python /workspace/hello.py")
    print(result.stdout)  # Hello world!

# Create an interactive Python REPL session
SESSION_ID=$(curl -s -X POST "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/repl/sessions" \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "python"}' | jq -r '.session_id')

# Execute code (variables persist across calls)
curl -s -X POST "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/repl/sessions/$SESSION_ID/execute" \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "import pandas as pd\ndf = pd.DataFrame({\"a\": [1,2,3]})"}'

# Variables persist — reference df from previous execution
curl -s -X POST "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/repl/sessions/$SESSION_ID/execute" \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code": "print(df.describe())"}'

# Destroy session when done
curl -s -X DELETE "https://api.sandbox.stateset.app/api/v1/sandbox/$SANDBOX_ID/repl/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $STATESET_API_KEY"

import { Sandbox } from '@stateset/sandbox-sdk';

const sandbox = await Sandbox.create();

// Create a REPL session
const session = await sandbox.createReplSession({ language: 'python' });

// Execute code with persistent state
const result1 = await sandbox.executeRepl(session.id, { code: 'x = 42' });
const result2 = await sandbox.executeRepl(session.id, { code: 'print(x * 2)' });
console.log(result2.outputs[0].text); // 84

// Clean up
await sandbox.destroyReplSession(session.id);
await sandbox.close();

// Base (default) — Node.js, Python, Git
const sandbox = await Sandbox.create();

// Claude Code — Claude CLI, Agent SDK, MCP servers
const sandbox = await Sandbox.create({ template: 'claude-code' });

// Browser — Playwright + Chromium
const sandbox = await Sandbox.create({ template: 'browser' });

// Computer-use — GUI actions with Xvfb, xdotool, and browser tooling
const sandbox = await Sandbox.create({ template: 'computer-use' });

// Computer-use benchmark — lower footprint profile for benchmark runs
const sandbox = await Sandbox.create({ template: 'computer-use-benchmark' });

// Rust development
const sandbox = await Sandbox.create({ template: 'rust' });

// Go development
const sandbox = await Sandbox.create({ template: 'go' });

export STATESET_API_KEY="sk-sandbox-..."
bash scripts/computer-use-smoke.sh --url https://example.com

pip install stateset-langchain

from stateset_langchain import SandboxToolkit

with SandboxToolkit.create() as toolkit:
    tools = toolkit.get_tools()
    # Use with any LangChain agent...

pip install stateset-openai

from stateset_openai import SandboxToolkit

with SandboxToolkit.create() as toolkit:
    response = client.chat.completions.create(
        model="gpt-4o",
        tools=toolkit.tool_definitions(),
        messages=messages,
    )

npm install @stateset/ai-sdk-sandbox

import { createSandboxTools } from '@stateset/ai-sdk-sandbox';

const { tools, cleanup } = await createSandboxTools();
const { text } = await generateText({ model, tools, maxSteps: 10, prompt });
await cleanup();

import { Sandbox } from '@stateset/sandbox-sdk';

async function runAgentTask(task: string) {
  const sandbox = await Sandbox.create({
    template: 'claude-code',
    cpus: '2',
    memory: '4Gi',
    timeout_seconds: 600,
  });

  try {
    // Pass the task as an argument rather than interpolating it into a shell
    // string. A task containing a quote or $(...) would otherwise break out of
    // the quoting and run as its own command inside the sandbox.
    const result = await sandbox.exec(['claude', '-p', task]);
    return {
      success: result.exit_code === 0,
      output: result.stdout,
      errors: result.stderr,
    };
  } finally {
    await sandbox.close();
  }
}

const result = await runAgentTask('Create a Python weather API');
console.log(result.output);

export STATESET_API_KEY="sk-sandbox-xxxx"
export STATESET_BASE_URL="https://api.sandbox.stateset.app"  # optional