Quickstart

export SANDBOX_API_KEY=your-api-key-here

import { Sandbox } from "@simplesandbox/sdk";

const client = Sandbox({
  apiKey: "your-api-key-here"
});

const sandbox = await client.sandboxes.create({
  image: "node:lts-alpine"
});

const sandbox = await client.sandboxes.create({
  image: "node:lts-alpine",
  timeoutMs: 600000 // 10 minutes
});

const result = await sandbox.exec("echo 'Hello World'");
console.log(result.stdout); // "Hello World\n"
console.log(result.exitCode); // 0

const result = await sandbox.exec("npm install && npm test");

const info = await sandbox.info();
console.log(info.state); // "started"
console.log(info.name); // "sandbox-node-1"

const sandboxes = await client.sandboxes.list();
for (const sb of sandboxes) {
  console.log(`${sb.id}: ${sb.data.state}`);
}

const updated = await sandbox.refresh();
console.log(updated.state);

await sandbox.kill();

import { Sandbox } from "@simplesandbox/sdk";

const client = Sandbox();

// Create sandbox
const sandbox = await client.sandboxes.create({
  image: "node:lts-alpine"
});

// Execute commands
const result = await sandbox.exec("node --version");
console.log(result.stdout); // v20.x.x

// Clean up
await sandbox.kill();

await sandbox.setTimeout(30 * 60_000); // 30 minutes

// Write
await sandbox.files.write("/app/config.json", JSON.stringify({ key: "value" }));

// Read
const content = await sandbox.files.read("/app/config.json");

await sandbox.exec("python server.py >/tmp/server.log 2>&1", {
  background: true
});

# Flask
app.run(host='::', port=5000)

const host = sandbox.expose(5000);
console.log(`https://${host}`);