GETTING STARTED

Quickstart

Provision a Firecracker microVM sandbox, run code inside it, and terminate it — all via REST API in under 5 minutes.

TypeScript SDKPython SDKAPI Reference

1Get an API key

Sign up at scaledminds.com/register, then navigate to Dashboard → API Keys → Create key. Copy the key — it is shown only once.

2Install the SDK

Choose your language:

# TypeScript / Node.js
npm install @scaledminds/sdk

# Python
pip install scaledminds

3Create a sandbox

// TypeScript
import { ScaledMinds } from "@scaledminds/sdk";

const client = new ScaledMinds({ apiKey: process.env.SCALEDMINDS_API_KEY });

// Boots in <200 ms
const sandbox = await client.environments.create({
  image: "python3.12",
  vcpus: 1,
  memoryMb: 512,
  timeoutSeconds: 300,
});

4Execute code

const result = await client.environments.exec(sandbox.id, {
  command: "python3 -c \"print('hello from Firecracker')\"",
});

console.log(result.stdout); // hello from Firecracker

5Terminate (billing stops immediately)

await client.environments.terminate(sandbox.id);
// Billing stops at the second of termination

Raw REST API

Prefer raw HTTP? Every SDK operation maps 1:1 to a REST endpoint.

curl -X POST https://api.scaledminds.com/api/v1/environments \
  -H "Authorization: Bearer $SCALEDMINDS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image": "python3.12", "vcpus": 1, "memoryMb": 512, "timeoutSeconds": 300 }'

Next steps