Python SDK

pip install stacyvm

import os
from stacyvm import Client

client = Client(
    base_url=os.getenv("STACYVM_URL", "http://localhost:7423"),
    api_key=os.getenv("STACYVM_API_KEY"),
    user_id="user_123",
    timeout=60.0,
)

from stacyvm import Client

client = Client(
    base_url="http://localhost:7423",
    api_key="sk_test_YOUR_API_KEY",
)

with client.spawn(image="python:3.12", ttl="10m") as sandbox:
    sandbox.write_file("/app/main.py", "print(sum([10, 20, 12]))\n")
    result = sandbox.exec("python3 /app/main.py", timeout="10s")

    if result.exit_code != 0:
        raise RuntimeError(result.stderr)

    print(result.stdout)

import sys

for chunk in sandbox.exec_stream("python3 -u /app/main.py"):
    if chunk.stream == "stdout":
        print(chunk.data, end="")
    else:
        print(chunk.data, end="", file=sys.stderr)

from stacyvm import Client, ProviderError, SandboxNotFound

client = Client("http://localhost:7423", api_key="sk_test_YOUR_API_KEY")

try:
    sandbox = client.spawn(image="python:3.12", ttl="10m")
    result = sandbox.exec("python3 /missing.py", timeout="10s")
except SandboxNotFound as exc:
    print(f"sandbox disappeared: {exc}")
except ProviderError as exc:
    print(f"runtime provider failed: {exc}")
finally:
    try:
        sandbox.destroy()
    except Exception:
        pass