How to run a Buddy sandbox (via web, CLI, API, or AI agent)

Create a Buddy sandbox in one command, with no Buddy account or API key. Or use the dashboard, an AI agent, the API, or the SDK. Median burst TTI 1,012 ms in our Nov 20, 2026 benchmark.

David Tice

Head of Product ·

Buddy runs each sandbox as an Ubuntu microVM served from a pre-warmed pool, with streamed command output, published ports, and snapshots.

You don't need a Buddy account, provider SDK, or API key to use it. ComputeSDK runs Buddy sandboxes on its managed Buddy account and bills them from your ComputeSDK credit. Sign up once, and you can create a Buddy sandbox from the dashboard, your terminal, an AI agent, a REST call, or a few lines of TypeScript. If you already have a Buddy account, you can bring your own key too.

  • Dashboard: open Sandboxes → New sandbox and pick Buddy.
  • CLI: run npm create buddy or compute new buddy.
  • MCP: connect Claude, ChatGPT, or another agent to https://platform.computesdk.com/mcp.
  • REST API: call POST /api/v1/sandboxes from any language.
  • SDK: import { compute } from 'computesdk' in a TypeScript app.

How Buddy performs

ComputeSDK benchmarks Buddy alongside every other sandbox provider on the same hardware and schedule. Its current results, as of November 20, 2026:

See every result on the Buddy provider page. Browse the burst TTI, DAX and reliability leaderboards.

Popular comparisons: Buddy vs Agent37, Buddy vs Archil, Buddy vs Arker.

Before you start

Create an account at platform.computesdk.com with Google, GitHub, or email. Your account comes with an organization, and every sandbox you create belongs to it.

Sandboxes on ComputeSDK's managed Buddy account are billed per second from your prepaid credit, which you can add under Settings → Billing. You only pay Buddy directly if you bring your own key.

1. Create a sandbox in the dashboard

  1. Sign in to platform.computesdk.com and open Sandboxes in the sidebar.
  2. Click New sandbox.
  3. Under Size, pick how much CPU and memory you want.
  4. Under Routing, pick Buddy.
  5. Click Create sandbox.

The New sandbox form on the ComputeSDK dashboard, with Size and Routing selected (shown with Vercel; the steps are the same for Buddy)

The new sandbox appears in the Sandboxes list, and you can destroy it from there when you're done.

These sizes were available on the managed Buddy account when we wrote this. The dashboard always shows the current list and the price for each one.

  • small: 1 vCPU · 2 GB · 50 GB disk
  • medium: 2 vCPU · 4 GB · 50 GB disk
  • large: 4 vCPU · 8 GB · 50 GB disk
  • xlarge: 8 vCPU · 16 GB · 50 GB disk

2. Create a sandbox from the CLI

The fastest way from a terminal is the Buddy starter:

npm create buddy

It offers to install the compute CLI if you don't have it, then runs compute new buddy for you. The first time, it opens your browser so you can sign in to ComputeSDK and pick your organization. After that, the sandbox is created and ready.

Running npm create vercel creates a sandbox through ComputeSDK (shown with Vercel; the steps are the same for Buddy)

If you already have the CLI, you can do the same in one command:

npm install -g @computesdk/cli
compute new buddy

If you aren't signed in yet, compute new opens the browser sign-in first (you can also run compute login yourself). The new sandbox becomes the current sandbox for your directory, so the next commands don't need its ID:

compute exec echo hello   # run a command
compute list              # see your sandboxes
compute destroy           # stop it and stop billing

compute new creates a sandbox and prints how to use it (shown with Vercel; the steps are the same for Buddy)

Run compute new buddy . to also copy your current project into the sandbox at /app.

3. Let an AI agent create it over MCP

ComputeSDK has a remote MCP server, so an AI agent can create and use sandboxes for you. Connect it to your agent:

  • Claude (web and desktop): go to Settings → Connectors → Add custom connector and enter https://platform.computesdk.com/mcp, or add ComputeSDK Router from the connectors directory.
  • Claude Code: run claude mcp add --transport http computesdk https://platform.computesdk.com/mcp.
  • ChatGPT: install the ComputeSDK Router app from the ChatGPT apps directory.
  • Any other MCP client: point it at https://platform.computesdk.com/mcp.

The first time the agent uses a tool, a ComputeSDK sign-in opens in your browser. Sign in with OAuth, choose the organization the agent should use, and approve the permissions. That's it. Now ask for what you want:

Create a Buddy sandbox, run node -v in it, and destroy it when you're done.

The agent creates the sandbox, runs commands, reads and writes files, starts servers, and shares a public preview URL for a port, all through ComputeSDK. Nothing runs on your computer. To disconnect, remove the app under Settings → Connected Apps.

4. Create a sandbox with the REST API

For direct calls from any language, use an organization API key:

  1. Sign in to the platform and open Settings → API Keys.
  2. Create a key and copy it. It is shown only once.
  3. Export it in your shell:
export COMPUTE_API_KEY="your_org_api_key"

Create a Buddy sandbox:

curl https://platform.computesdk.com/api/v1/sandboxes \
  -H "Authorization: Bearer $COMPUTE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"only":["buddy"],"size":"small"}'

only limits this create to Buddy. The response's sandbox.id is what you use in the next calls. Run a command, then destroy the sandbox:

curl https://platform.computesdk.com/api/v1/sandboxes/$SANDBOX_ID/commands \
  -H "Authorization: Bearer $COMPUTE_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"command":"echo hello"}'
 
curl -X DELETE https://platform.computesdk.com/api/v1/sandboxes/$SANDBOX_ID \
  -H "Authorization: Bearer $COMPUTE_API_KEY"

Creating a sandbox and running a command with curl (shown with Vercel; the steps are the same for Buddy)

The same API also handles files, background processes, and preview URLs. See the API reference.

5. Create a sandbox with the SDK

In a TypeScript or JavaScript app, install the SDK and use the same API key:

npm install computesdk
export COMPUTE_API_KEY="your_org_api_key"
import { compute } from 'computesdk';
 
const sandbox = await compute.instances.create({
  // Follows your routing under Settings → Sandboxes; pick Buddy there.
  size: 'small',
});
try {
  const result = await sandbox.runCommand('echo hello');
  console.log(result.stdout);
} finally {
  await sandbox.destroy();
}

Importing computesdk is all it takes: the SDK reads COMPUTE_API_KEY and talks to the platform, so there is no Buddy package or Buddy credential in your app. compute.instances.create() follows your organization's saved routing, so pick Buddy under Settings → Sandboxes to send sandboxes there. The SDK can't pin a single create to ComputeSDK's managed Buddy account; only the routing setting does that. If you've connected your own Buddy key, providerOrder: ['buddy'] pins one create to that key, with no fallback.

Creating a sandbox with the computesdk package

Bring your own key: try it first, or as a fallback

If you already have a Buddy account, you can connect its key to ComputeSDK and decide how it is used alongside the managed account. Sandboxes on your own key are billed by Buddy, not from your ComputeSDK credit.

  1. Add your key under Settings → BYOK.
  2. Open Settings → Sandboxes and set Use BYOK accounts:
  • First: try your own keys first, then ComputeSDK's managed accounts.
  • Fallback: use managed accounts first, then fall back to your own keys.
  • Only: use only your own keys.
  • Off: use only managed accounts.

The Use BYOK accounts setting under Settings → Sandboxes

The setting applies everywhere: the dashboard, CLI, MCP, API, and SDK. You can still override it for a single create, for example compute new buddy --byok to use your key or compute new buddy --managed to use the managed account. From the API, set it with PATCH /api/v1/sandboxes/routing and {"byok":"first"}, or pass byok on a single create.

Next steps

Frequently asked questions

Do I need a Buddy account to run a Buddy sandbox?

No. ComputeSDK runs Buddy sandboxes on its managed Buddy account and bills them per second from your ComputeSDK credit. You can also connect your own Buddy key.

How do I create a Buddy sandbox from the terminal?

Run npm create buddy or compute new buddy. The first time, the CLI opens your browser so you can sign in to ComputeSDK. Then run commands with compute exec and clean up with compute destroy.

Can an AI agent create Buddy sandboxes?

Yes. Connect Claude, ChatGPT, or another MCP client to https://platform.computesdk.com/mcp and sign in with OAuth. The agent can then create a Buddy sandbox, run commands, edit files, and destroy it.

Can I use my own Buddy key with ComputeSDK?

Yes. Add it under Settings → BYOK, then set Use BYOK accounts under Settings → Sandboxes to First to try your key before managed accounts, or Fallback to use managed accounts first and your key as a backup.

Get new posts by email

Questions or thoughts on this post?

Join the conversation on X