Skip to content
sistemo.io beta
GitHub Docs Quickstart

Cloud quickstart

Private beta

Sistemo Cloud is not open for signups yet, and the SDK packages below are not published until it is. Request an invite — the source is public on GitHub meanwhile.

Run AI-generated / untrusted code in a real microVM in under 10 minutes.

1. Get an API key

  1. Sign in to the dashboard.
  2. Go to API Keys → Create key.
  3. Choose the full scope (read + run) and copy the sk_live_… secret — it's shown once.
export SISTEMO_API_KEY=sk_live_xxxxxxxxxxxxxxxx

read vs full

A read key can list resources but can't create sandboxes or run code. Use full with the SDK. See API keys.

2. Install the SDK

Both SDKs are zero-dependency thin wrappers over the REST API.

pip install sistemo

npm install @sistemo/sdk

3. Run code in a sandbox

from sistemo import Sandbox

# Reads SISTEMO_API_KEY from the environment.
with Sandbox() as sb:
    r = sb.run("python3 -c 'print(2 + 2)'")
    print(r.stdout)      # "4\n"
    print(r.exit_code)   # 0

import { Sandbox } from "@sistemo/sdk";

const sb = await Sandbox.create();
const r = await sb.run("node -e 'console.log(2 + 2)'");
console.log(r.stdout, r.exitCode);
await sb.close();

Each Sandbox() is a real Firecracker microVM booted on demand. Run as many commands as you need, then close it — compute billing stops when the sandbox is gone.

What run() returns

Field Description
stdout Standard output of the command
stderr Standard error
exit_code / exitCode Process exit code

Under the hood

The SDK calls three endpoints:

Step Endpoint
Create a sandbox POST /v1/machines
Run a command POST /v1/machines/{id}/exec
Tear it down DELETE /v1/machines/{id}

Authenticate every request with Authorization: Bearer sk_live_…. See API keys.

Next

Self-hosting the open-source engine? See Self-hosting (optional).