Freestyle

Freestyle provider for ComputeSDK: full Linux virtual machines designed for long-running, complex agent tasks, with instant startup, persistence, and cheap snapshotting.

Installation & Setup

npm install @computesdk/freestyle

Add your Freestyle credentials to a .env file:

FREESTYLE_API_KEY=your_freestyle_api_key

Freestyle base images ship no language runtime, so the first sandbox on an account bakes a Node + Python snapshot once (~20 s) and every sandbox after boots from it in ~200–300 ms. Set FREESTYLE_SNAPSHOT_ID (or the snapshotId option) to your own snapshot to skip baking.

Usage

import { freestyle } from '@computesdk/freestyle';

const compute = freestyle({
  apiKey: process.env.FREESTYLE_API_KEY,
});

// Create sandbox
const sandbox = await compute.sandbox.create();

// Run a command
const result = await sandbox.runCommand('echo "Hello from Freestyle!"');
console.log(result.stdout); // "Hello from Freestyle!"

// Clean up
await sandbox.destroy();

Configuration Options

interface FreestyleConfig {
  /** Freestyle API key. Falls back to FREESTYLE_API_KEY. */
  apiKey?: string;
  /** Snapshot every sandbox boots from. Falls back to FREESTYLE_SNAPSHOT_ID; auto-baked when unset. */
  snapshotId?: string;
  /** API base URL. Falls back to FREESTYLE_API_URL, then the SDK default. */
  baseUrl?: string;
  /** Idle seconds before Freestyle stops the VM. Default: 300 */
  idleTimeoutSeconds?: number;
  /** Default wall-clock limit for a single command, ms. Default: 300000 */
  timeout?: number;
  /** Keep the VM after it stops instead of deleting it. Default: ephemeral */
  persistent?: boolean;
  /** Outbound firewall. Defaults to allow-all outbound; pass { rules: [] } to seal. */
  firewall?: { rules: unknown[] };
}

Capabilities

Freestyle VMs are full Linux guests, so the whole filesystem surface is native rather than shelled through runCommand:

await sandbox.filesystem.writeFile('/tmp/app.js', 'console.log("hi")');
await sandbox.filesystem.readFile('/tmp/app.js');
await sandbox.filesystem.readdir('/tmp');
await sandbox.filesystem.mkdir('/tmp/sub');
await sandbox.filesystem.exists('/tmp/app.js');
await sandbox.filesystem.remove('/tmp/app.js');

Snapshots (compute.snapshot.create / list / delete) and reconnect-by-id (compute.sandbox.getById) are supported. getUrl is not: Freestyle exposes VMs through mapped domains (freestyle.domains), not a stock per-port URL.