Quickstart: Run Your First Cua Sandbox in 5 Minutes

import asyncio
from cua import Sandbox, Image

async def main():
    # Starts an ephemeral Linux desktop container via Docker.
    # The sandbox is destroyed automatically when the block exits.
    async with Sandbox.ephemeral(
        Image.linux(kind="container"),
        local=True,
    ) as sb:
        # Run a shell command inside the sandbox
        result = await sb.shell.run("uname -a")
        print("Shell output:", result.stdout)

        # Read and write the sandbox clipboard
        await sb.clipboard.set("Hello from Cua!")
        value = await sb.clipboard.get()
        print("Clipboard:", value)

        # Take a screenshot of the sandbox desktop
        screenshot = await sb.screenshot()
        with open("screenshot.png", "wb") as f:
            f.write(screenshot)
        print("Screenshot saved to screenshot.png")

asyncio.run(main())