@deablabs/sando-sdk

The TypeScript client for Sando, a self-hosted microVM sandbox service built on Bun and Microsandbox.

Install

bun add @deablabs/sando-sdk

Usage

import { Sandbox } from "@deablabs/sando-sdk";

const sandbox = await Sandbox.create({
  image: "node:22",
  ports: [3000],
});

const result = await sandbox.exec("node", ["--version"]);
console.log(result.stdout);

await sandbox.destroy();

Set SANDBOX_API_KEY and, when the service is not running at http://127.0.0.1:4000, SANDBOX_API_URL. You can also pass apiKey and apiUrl directly to the client.

The SDK requires Bun because authenticated exec streams use Bun's WebSocket client headers.

License

MIT