Namespace Sandboxes with ComputeSDK

Run code on Namespace’s cloud container instances through ComputeSDK’s unified API. Namespace provides ephemeral containers with customizable CPU and memory allocation — ideal when you need control over compute resources, specific architectures, or lightweight isolated environments.

Setup

npm install computesdk

# .env
COMPUTESDK_API_KEY=your_computesdk_api_key
NSC_TOKEN=your_namespace_nsc_token

Get your ComputeSDK key at https://console.computesdk.com/register

Quick Start

import { compute } from 'computesdk';
// Auto-detects Namespace from environment variables

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

const result = await sandbox.runCode('print("Hello from Namespace!")');
console.log(result.output);

await sandbox.destroy();

Explicit Configuration

For multi-provider setups or when you want to be explicit:

import { compute } from 'computesdk';

compute.setConfig({
  computesdkApiKey: process.env.COMPUTESDK_API_KEY,
  provider: 'namespace',
  namespace: {
    token: process.env.NSC_TOKEN,
  }
});

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

Custom Resources

Namespace lets you customize the compute resources for your sandboxes:

compute.setConfig({
  computesdkApiKey: process.env.COMPUTESDK_API_KEY,
  provider: 'namespace',
  namespace: {
    token: process.env.NSC_TOKEN,
    virtualCpu: 4,
    memoryMegabytes: 8192,
  }
});

Namespace Configuration Options

interface NamespaceConfig {
  token?: string;              // Uses NSC_TOKEN env var if not set
  virtualCpu?: number;         // CPU cores (default: 2)
  memoryMegabytes?: number;    // RAM in MB (default: 4096)
  machineArch?: string;        // Architecture (default: 'amd64')
  os?: string;                 // Operating system (default: 'linux')
}

Full API

ComputeSDK provides the same API across all providers: filesystem operations, shell commands, managed servers, overlays, terminals, and client access.

Install the main skill for the complete reference:

npx skills add https://github.com/computesdk/sandbox-skills --skill computesdk

Or see https://www.computesdk.com/docs/reference/sandbox/