Python SDK¶

Private beta

Signups are invite-only. Request an invite. The Python SDK is on PyPI; you still need a dashboard API key to run anything.

The official Python client — a thin, zero-dependency (stdlib-only) wrapper over the REST API.

Install¶

python3 -m venv .venv && source .venv/bin/activate
pip install sistemo

Requires Python 3.9+. On Debian/Ubuntu/Fedora the system Python is externally managed (PEP 668) — the venv is not optional.

Configure¶

export SISTEMO_API_KEY=sk_live_xxxxxxxxxxxxxxxx
# optional — override the API endpoint:
export SISTEMO_BASE_URL=https://your-own-host:8000

Get a key from the dashboard → API Keys (choose full scope). See the Cloud quickstart.

Hello, sandbox¶

from sistemo import Sandbox

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

Each Sandbox() boots a real Firecracker microVM. The with block destroys it (and stops billing) on exit. run() waits until the command finishes (default 120 s, max 24 hours).

What's here¶

Quickstart — first sandbox, step by step
Sandbox API — every option and method
Error handling — exception types
Examples — agent code, files, multiple commands

Source & versions¶

Open-source. The SDK sends a User-Agent header on every request (required — generic UAs are blocked by the cloud WAF). Pin a version in production:

pip install "sistemo==0.1.*"