Python SDK

pip install podflare

from podflare import Sandbox, Client

# Default: reads PODFLARE_HOSTD_URL env var, falls back to https://api.podflare.ai
sbx = Sandbox()

# Explicit host
sbx = Sandbox(host="https://api.podflare.ai")

# Share a Client across many sandboxes (avoids per-sandbox httpx.Client)
client = Client(host="https://api.podflare.ai")
a = Sandbox(client=client)
b = Sandbox(client=client)

r = sbx.run_code("print(sum(range(10)))")
assert r.exit_code == 0
assert r.stdout.strip() == "45"

for ev in sbx.run_code_stream("for i in range(3): print(i)"):
    if ev.type == "stdout":
        print(ev.data, flush=True)
    elif ev.type == "exit":
        print("done, exit", ev.data)

children = parent.fork(n=5)

d = a.diff(b)
# {"added": [...], "removed": [...], "modified": [...]}

parent.merge_into(winner)

sbx.upload(b"hello", "/root/hello.txt")
assert sbx.download("/root/hello.txt") == b"hello"

# Preferred:
with Sandbox() as s:
    ...  # destroyed automatically

# Manual:
s = Sandbox()
try:
    ...
finally:
    s.close()

from podflare import ExecResult, Event, Language