BoxLite Cloud vs open source

# Runs on your own machine. Requires hardware virtualization (KVM or Hypervisor.framework).
import asyncio
import os
import tempfile

import boxlite


async def main() -> None:
    # A host directory the box will read and write directly.
    with tempfile.TemporaryDirectory() as host_dir:
        with open(os.path.join(host_dir, "notes.txt"), "w") as f:
            f.write("written on the host\n")

        try:
            async with boxlite.SimpleBox(
                image="alpine:latest",
                volumes=[(host_dir, "/data")],
            ) as box:
                result = await box.exec("cat", "/data/notes.txt")
                # A non-zero exit code does not raise — check it yourself.
                print(result.stdout if result.exit_code == 0 else result.stderr, end="")
        except RuntimeError as exc:
            print("Box failed to start:", exc)


asyncio.run(main())

# Runs against BoxLite Cloud. No local virtualization needed.
# Set BOXLITE_API_KEY, and BOXLITE_VOLUME_ID to a volume you created in the console.
import asyncio
import os
import time

from boxlite import ApiKeyCredential, Boxlite, BoxliteRestOptions, BoxOptions


async def main() -> None:
    api_key = os.environ.get("BOXLITE_API_KEY")  # <YOUR_API_KEY>
    volume_id = os.environ.get("BOXLITE_VOLUME_ID")  # <YOUR_VOLUME_ID>
    if not api_key or not volume_id:
        print("Set BOXLITE_API_KEY and BOXLITE_VOLUME_ID before running this script.")
        return

    # Synchronous construction. No path_prefix on Cloud.
    rt = Boxlite.rest(
        BoxliteRestOptions(
            url=os.environ.get("BOXLITE_REST_URL", "https://app.boxlite.ai/api"),
            credential=ApiKeyCredential(api_key),
        )
    )

    box = None
    try:
        box = await rt.create(
            BoxOptions(
                image="ghcr.io/boxlite-ai/boxlite-agent-base:v0.1.0",
                # A managed volume replaces the host bind mount.
                volumes=[(volume_id, "/data")],
            ),
            name=f"port-demo-{int(time.time())}",  # name belongs to create(), not BoxOptions
        )
        await box.start()

        # Write into the volume, then read it back. The data survives this box.
        write = await box.exec("sh", args=["-c", "echo 'written in the box' > /data/notes.txt"])
        await write.wait()

        execution = await box.exec("cat", args=["/data/notes.txt"])
        output = ""
        async for line in execution.stdout():
            output += line
        result = await execution.wait()

        print(f"Exit code: {result.exit_code}")
        print(output)
    except Exception as exc:
        print(f"Cloud call failed: {exc!r}")
    finally:
        # Teardown lives on the runtime, not on the box.
        if box is not None:
            await rt.remove(box.id, force=True)


asyncio.run(main())