Python SDK¶

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.

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

Install¶

pip install sistemo

Requires Python 3.8+.

Configure¶

export SISTEMO_API_KEY=sk_live_xxxxxxxxxxxxxxxx
# optional — point at a self-hosted control plane:
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.

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.*"