Python SDK

from prime_sandboxes import SandboxClient, CreateSandboxRequest, APIClient

client = SandboxClient(APIClient())

sandbox = client.create(
    CreateSandboxRequest(name="sdk-demo", docker_image="python:3.11-slim")
)
client.wait_for_creation(sandbox.id)
print(client.execute_command(sandbox.id, "python -c 'print(42)'").stdout)
client.delete(sandbox.id)

import asyncio
from prime_sandboxes import AsyncSandboxClient, CreateSandboxRequest

async def main() -> None:
    async with AsyncSandboxClient() as sandboxes:
        sandbox = await sandboxes.create(
            CreateSandboxRequest(name="sdk-demo", docker_image="python:3.11-slim")
        )
        await sandboxes.wait_for_creation(sandbox.id)
        result = await sandboxes.execute_command(sandbox.id, "python -c 'print(42)'")
        print(result.stdout.strip())
        await sandboxes.delete(sandbox.id)

asyncio.run(main())

async def create_many(images: list[str]) -> None:
    async with AsyncSandboxClient() as sandboxes:
        requests = [
            CreateSandboxRequest(
                name=f"batch-{i}", docker_image=image, idempotency_key=f"batch-{i}"
            )
            for i, image in enumerate(images, start=1)
        ]
        created = await asyncio.gather(*[sandboxes.create(req) for req in requests])
        await sandboxes.bulk_wait_for_creation([sbx.id for sbx in created])
        print("Ready:", ", ".join(sbx.name for sbx in created))