Run Your First Sandbox

python -m pip install boxrouter

npm install @boxrouter/sdk

# macOS and Linux
curl -fsSL https://boxrouter.ai/install | sh
# Windows, in PowerShell
irm https://boxrouter.ai/install.ps1 | iex

from boxrouter import BoxRouter

with BoxRouter() as client:
    with client.sandboxes.create() as box:
        print("sandbox:", box.id, flush=True)
        print(box.exec("echo hello", check=True).stdout, end="")
    print("state:", box.state)  # the with block's destroy returned the sandbox

import { BoxRouter } from '@boxrouter/sdk';
await using client = new BoxRouter();
await using box = await client.sandboxes.create();
console.log('sandbox:', box.id);
const result = await box.exec('echo hello', { check: true });
process.stdout.write(result.stdout);

boxrouter run 'echo hello'

(
  set -euo pipefail
  API=${BOXROUTER_BASE_URL:-https://api.boxrouter.ai/api/v1}
  AUTH="Authorization: Bearer $BOXROUTER_API_KEY"
  id=$(curl -sS --fail-with-body -X POST "$API/sandboxes" -H "$AUTH" | jq -er '.id')
  echo "sandbox: $id"
  cleanup() {
    curl -sSf -X DELETE "$API/sandboxes/$id" -H "$AUTH" | jq -r '"state: " + .state'
  }
  trap cleanup EXIT
  curl -sS --fail-with-body "$API/sandboxes/$id/commands" -H "$AUTH" \
    -H "Content-Type: application/json" -d '{"command": "echo hello"}' |
    jq -ej 'if .exit_code == 0 then .stdout else error("Command exited with \(.exit_code)") end'
)