Official SDK libraries for smolvm - lightweight microVM sandboxes for secure code execution.

import { Sandbox } from 'smolvm';

const sandbox = await Sandbox.create({ name: 'my-sandbox' });

// Execute command in microVM
const result = await sandbox.exec(['echo', 'Hello from microVM!']);
console.log(result.stdout);

// Run in container
const pyResult = await sandbox.run('python:3.12-alpine', ['python', '-c', 'print("Hello!")']);
console.log(pyResult.stdout);

await sandbox.stop();

import asyncio
from smolvm import Sandbox, SandboxConfig

async def main():
    config = SandboxConfig(name="my-sandbox")

    async with Sandbox(config) as sandbox:
        await sandbox.start()

        # Execute command in microVM
        result = await sandbox.exec(["echo", "Hello from microVM!"])
        print(result.stdout)

        # Run in container
        py_result = await sandbox.run("python:3.12-alpine", ["python", "-c", "print('Hello!')"])
        print(py_result.stdout)

asyncio.run(main())

All SDKs provide:

• Sandbox Management - Create, start, stop, delete sandboxes
• Command Execution - Run commands directly in the microVM
• Container Support - Run OCI containers (Docker images) inside sandboxes
• Volume Mounts - Mount host directories into sandboxes
• Resource Control - Configure CPU and memory limits
• Streaming Logs - Stream stdout/stderr from sandboxes
• Language Presets - Quick helpers for Python, Node.js, etc.

• smolvm server running (default: http://127.0.0.1:8080)
• macOS with Apple Silicon, or Linux with KVM support

All SDKs follow the same API patterns:

See the main smolvm repository for contribution guidelines.

MIT