Cua

Build, benchmark, and deploy agents that use computers

Choose Your Path

Cua - Agent-Ready Sandboxes for Any OS

Build agents that see screens, click buttons, and complete tasks autonomously. One API for any VM or container image — cloud or local.

pip install cua

-->

# Requires Python 3.11 or later
from cua import Sandbox, Image

# Same API regardless of OS or runtime
async with Sandbox.ephemeral(Image.linux()) as sb:   # or .macos() .windows() .android()
    result = await sb.shell.run("echo hello")
    screenshot = await sb.screenshot()
    await sb.mouse.click(100, 200)
    await sb.keyboard.type("Hello from Cua!")
    await sb.mobile.gesture((100, 500), (100, 200))  # multi-touch gestures

[Get Started](https://cua.ai/docs/cua/guide/get-started/set-up-sandbox) | [Examples](https://cua.ai/docs/cua/examples) | [API Reference](https://cua.ai/docs/cua/reference/agent-sdk)

CuaBot - Co-op computer-use for any agent

cuabot gives any coding agent a seamless sandbox for computer-use. Individual windows appear natively on your desktop with H.265, shared clipboard, and audio.

npx cuabot                 # Setup onboarding

# Run any agent in a sandbox
cuabot claude              # Claude Code
cuabot openclaw            # OpenClaw in the sandbox

# Run any GUI workflow in a sandbox
cuabot chromium
cuabot --screenshot
cuabot --type "hello"
cuabot --click   [button]

Built-in support for agent-browser and agent-device (iOS, Android) out of the box.

[Get Started](https://cua.ai/docs/cuabot/guide/getting-started/introduction) | [Installation](https://cua.ai/docs/cuabot/guide/getting-started/installation) | First spotted at ClawCon

Cua-Bench - Benchmarks & RL Environments

Evaluate computer-use agents on OSWorld, ScreenSpot, Windows Arena, and custom tasks. Export trajectories for training.

-->

# Install and create base image
cd cua-bench
uv tool install -e . && cb image create linux-docker