Cua SDK

Build agentic apps and workflows on real desktops. Cua SDK gives your application isolated Linux, Windows and macOS machines, locally or in the cloud, runs the agents you already use inside them, and streams everything back so your users can watch, take over or teleport work in and out. Cua Driver is how the agents drive each desktop.

The same code runs on your machine (local=True, the default) or in the cloud (local=False). Any OCI image works; commands, services, readiness probes, public URLs and port forwards behave the same on both.

from cua_sandbox import Image, Sandbox, http
 
async with Sandbox.ephemeral(
    Image.from_registry("python:3.12-slim"),
    command=["python", "-m", "http.server", "8000"],
    services={"web": 8000},
    wait_for=http("web", "/"),
    local=True,
) as sb:
    print((await sb.service("web").request("GET", "/")).status_code)  # 200

Local and cloud#

For named pools, fixed warm capacity or Terraform, see Cua Fleets.

Packages#

How it fits together#

The SDK is one Rust core with generated bindings, running in your process or in cua daemon. It starts local runtimes itself and reaches the cloud through the Fleet gateway. Nothing needs to run inside the image; images that ship cua-spacesd (such as Image.linux()) also get the computer interfaces: sb.shell, sb.files, sb.screen, sb.mouse, sb.keyboard. See How sandboxes work.

To control the machine you are on instead of a sandbox, use Cua Driver.

Next: Your first sandbox.