cua-local-sandbox

name	cua-local-sandbox
description	Run Cua sandboxes locally - no API key required. Covers Docker (XFCE/Kasm) for Linux containers, QEMU for full VMs, Lume for macOS guests on Apple Silicon, and Tart for Apple VZ VMs. Use when the user wants a local sandbox, wants to keep things off the cloud, or asks "spin up an Ubuntu desktop", "open a sandbox VM", "let me try this safely first".

Local Cua sandbox

In mode: "local" (the default), cua_sandbox_start spins up a sandbox on your machine. Cua picks the runtime from the image OS unless you pass runtime explicitly.

Runtime selection

OS image	Auto runtime	When kind: "container"	Override
linux	Docker (XFCE)	XFCE Docker (trycua/cua-xfce)	qemu, docker
macos	Lume (Apple Silicon required)	-	tart
windows	QEMU Docker	-	-
android	Android Emulator	-	-

kind defaults to "container" for Linux (fast, GUI via XFCE) and "vm" for everything else.

Prerequisites

• Docker Desktop or Colima for Linux containers / Windows VMs
• macOS Apple Silicon for Image.macos() via Lume
• qemu installed locally for