Compute resources

# Python 3.10+; requires pip install boxlite
import asyncio
from boxlite import SimpleBox

async def main() -> None:
    try:
        # SimpleBox is an async context manager; the sandbox is only created and started on entry
        async with SimpleBox(
            image="alpine:latest",
            cpus=2,            # 2 vCPUs
            memory_mib=1024,   # 1024 MiB of memory
            # disk_size_gb is not a direct SimpleBox parameter;
            # it is passed through to the underlying BoxOptions via **kwargs (see notes below)
            disk_size_gb=8,    # 8 GB disk
        ) as box:
            # a non-zero exit code does not raise; check exit_code yourself
            result = await box.exec("nproc")
            print("vCPU:", result.stdout.strip())

            mem = await box.exec("sh", "-c", "free -m | awk '/Mem:/{print $2}'")
            print("Memory (MiB):", mem.stdout.strip())

            # busybox df: use -h for human-readable total (alpine lacks GNU df's -BG)
            disk = await box.exec("sh", "-c", "df -h / | awk 'NR==2{print $2}'")
            print("Disk:", disk.stdout.strip())
    except RuntimeError as exc:
        # no virtualization / image pull failure raises a standard RuntimeError
        print("startup failed:", exc)

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

// Node 18+; requires npm install @boxlite-ai/boxlite
import { SimpleBox } from "@boxlite-ai/boxlite";

async function main(): Promise<void> {
  try {
    // SimpleBox supports await using (asyncDispose); cleanup happens automatically on leaving scope
    await using box = new SimpleBox({
      image: "alpine:latest",
      cpus: 2, // 2 vCPUs
      memoryMib: 1024, // 1024 MiB of memory
      diskSizeGb: 8, // 8 GB disk
    });

    const result = await box.exec("nproc");
    console.log("vCPU:", result.stdout.trim());
  } catch (err) {
    // no virtualization / missing command throws a standard Error (not necessarily BoxliteError)
    console.error("startup failed:", err);
  }
}

main();

# Python: explicit specification, deterministic result (does not rely on any implicit default)
import asyncio
from boxlite import SimpleBox

async def main() -> None:
    try:
        async with SimpleBox(image="alpine:latest", cpus=2, memory_mib=1024) as box:
            print((await box.exec("nproc")).stdout.strip())
    except RuntimeError as exc:
        print("startup failed:", exc)

asyncio.run(main())