Python quickstart

export NEBIUS_API_KEY="YOUR_API_KEY"
export NEBIUS_PROJECT_ID="YOUR_PROJECT_ID"

mkdir sandboxes-quickstart
cd sandboxes-quickstart
uv init --bare --python 3.12
uv add "contree-sdk==0.3.6"

import asyncio

from contree_sdk import Contree


async def main() -> None:
    client = Contree()
    base = await client.images.use("alpine:3.19", strict=True)

    # Choose persistence before the operation is submitted.
    preparation = base.run(
        shell="printf 'ready\\n' > /tmp/status.txt",
        disposable=False,
    )
    checkpoint = await preparation

    if checkpoint.exit_code != 0:
        raise RuntimeError(f"Preparation failed: {checkpoint.stderr}")
    if checkpoint.uuid is None:
        raise RuntimeError("Preparation returned no reusable image UUID")

    print(f"Saved image UUID: {checkpoint.uuid}")

    reuse = checkpoint.run(
        shell="cat /tmp/status.txt",
        disposable=True,
    )
    result = await reuse

    if result.exit_code != 0:
        raise RuntimeError(f"Reuse failed: {result.stderr}")

    print(result.stdout, end="")


if __name__ == "__main__":
    asyncio.run(main())

uv run python quickstart.py

ready