Modal

Modal Sandbox BenchmarksComputeSDK

Modal provider for ComputeSDK - Execute code with GPU support for machine learning workloads.

Installation & Setup

npm install @computesdk/modal

Add your Modal credentials to a .env file:

MODAL_TOKEN_ID=your_modal_token_id
MODAL_TOKEN_SECRET=your_modal_token_secret

Usage

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

const compute = modal({
  tokenId: process.env.MODAL_TOKEN_ID,
  tokenSecret: process.env.MODAL_TOKEN_SECRET,
});

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

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

// Clean up
await sandbox.destroy();

Configuration Options

interface ModalConfig {
  /** Modal token ID - if not provided, will use MODAL_TOKEN_ID env var */
  tokenId?: string;
  /** Modal token secret - if not provided, will use MODAL_TOKEN_SECRET env var */
  tokenSecret?: string;
  /** Execution timeout in milliseconds */
  timeout?: number;
  /** Modal environment (sandbox or main) */
  environment?: string;
  /** Ports to expose (unencrypted by default) */
  ports?: number[];
  /** Port for the daemon SSE channel (defaults to 38989); set false to disable */
  daemonSsePort?: number | false;
  /** Modal app name (default: 'computesdk-modal') */
  appName?: string;
  /** Use Modal's experimental scalable sandboxes API */
  scalableSandboxes?: boolean;
}

Ports are exposed with unencrypted tunnels by default for maximum compatibility.