Templates

import { Sandbox } from '@opencomputer/sdk';
import { Image } from '@opencomputer/sdk/node';

// Define an image with packages, env vars, and files
const image = Image.base()
  .aptInstall(['curl', 'jq'])
  .pipInstall(['requests', 'pandas'])
  .env({ PROJECT_ROOT: '/workspace' })
  .workdir('/workspace');

// Create a sandbox — the image is built on first run, cached after
const sandbox = await Sandbox.create({
  image,
  timeout: 300,
  onBuildLog: (log) => console.log(`build: ${log}`),
});

const result = await sandbox.exec.run('which curl');
console.log(result.exitCode); // 0

// 8 GB to build…
const image = Image.base()
  .aptInstall(['build-essential', 'cmake'])
  .runCommands('make -j')
  .builderMemory(8192);

// …but the sandbox runs at whatever you ask for
const sandbox = await Sandbox.create({ image, memoryMB: 4096 });

import { Image, Snapshots } from '@opencomputer/sdk/node';

const snapshots = new Snapshots();

// Define the image
const image = Image.base()
  .aptInstall(['python3-pip'])
  .pipInstall(['pandas', 'numpy', 'scikit-learn'])
  .workdir('/workspace');

// Create a named snapshot with build log streaming
await snapshots.create({
  name: 'data-science',
  image,
  onBuildLogs: (log) => console.log(`build: ${log}`),
});

// Now create sandboxes from the snapshot — instant, no build step
const sandbox = await Sandbox.create({ snapshot: 'data-science' });

// Fork the snapshot with 8 GB instead of its captured size
const sandbox = await Sandbox.create({ snapshot: 'data-science', memoryMB: 8192 });

const snapshots = new Snapshots();

// List all snapshots
const list = await snapshots.list();
for (const s of list) {
  console.log(`${s.name} — ${s.status}`);
}

// Get a specific snapshot
const snapshot = await snapshots.get('data-science');
console.log(snapshot.status); // "ready"

// Delete a snapshot
await snapshots.delete('data-science');