Quick Start

From zero to a running sandbox in three steps. Everything is self-service — no demo call, no waitlist.

1. Create an account and an API key

Sign up at console.ovrin.app. New accounts start on the Free plan: 100 sandbox minutes, no card required.

In the console's API keys page, create a key. It is shown once and stored hashed — copy it somewhere safe:

export OVRIN_API_KEY="ovrin_..."

Scope your keys

A key can be limited to one surface — sandboxes, memory, or secrets — so a leaked partial key cannot read your usage or touch billing. You can also set an expiry. See API Keys & Scopes.

2. Install the SDK

Python

pip install ovrin

TypeScript

npm install ovrin

curl

# Nothing to install — the API is plain REST.

See Installation for details and the SDK reference for the full surface.

3. Create a sandbox and use it

Every sandbox is a full Linux environment with a filesystem, network stack, process table and shell.

Python

import ovrin

client = ovrin.Client()  # reads OVRIN_API_KEY

sandbox = client.sandboxes.create(template="python", timeout=3600)
result = sandbox.run("python -c 'print(2 + 2)'")
print(result.stdout)          # 4

sandbox.files.write("/workspace/hello.txt", "hi")
print(sandbox.files.read("/workspace/hello.txt"))

sandbox.kill()

TypeScript

import { Ovrin } from "ovrin";

const client = new Ovrin(); // reads OVRIN_API_KEY

const sandbox = await client.sandboxes.create({
  template: "python",
  timeout: 3600,
});
const result = await sandbox.run("python -c 'print(2 + 2)'");
console.log(result.stdout);   // 4

await sandbox.files.write("/workspace/hello.txt", "hi");

await sandbox.kill();

curl

curl -X POST https://api.ovrin.app/sandboxes \
  -H "Authorization: Bearer $OVRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"python","timeout":3600}'

# => {"id":"sbx_x1","state":"Running", ...}

curl -X POST https://api.ovrin.app/sandboxes/sbx_x1/run \
  -H "Authorization: Bearer $OVRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command":"echo hello"}'

Where to next

• Agent environments — Claude Code, Codex, Gemini CLI, DeepSeek Harness, Chrome and Playwright templates.
• MCP server — give Claude, Cursor, and other MCP clients a computer on Ovrin.
• Persistent memory — context that outlives sandboxes.
• Plans & billing — what the Free plan includes and how metered compute works.