Prerequisites
An OpenComputer API key and the SDK installed. See Introduction for install instructions.
bash
1export OPENCOMPUTER_API_KEY=your-api-key
Grab your API key from app.opencomputer.dev
Ask AI about this page
Create Your First Sandbox
typescript
123456789import { Sandbox } from "@opencomputer/sdk"; const sandbox = await Sandbox.create(); // Run a command inside the sandbox const result = await sandbox.commands.run("echo 'Hello World from OpenSandbox!'"); console.log(result.stdout); await sandbox.kill();
Running this will print:
bash
1Hello World from OpenSandbox!
Your sandboxes stay alive as long as you need them. They don't shut down after a command finishes — you can keep running commands, installing packages, and building projects for hours or days. Sandboxes only stop when you explicitly kill them or when the idle timeout expires (default 5 minutes, configurable).