Raw capture — raw/trycua-cua.md

url: https://github.com/trycua/cua date_fetched: 2026-07-05 backfilled: true

Building your own agent? Start with Cua · Giving a coding agent a computer? Cua Drivers · Evaluating or training models? Cua Bench · Need macOS VMs? Lume

Drive native desktop apps in the background. Agents click, type, and verify without stealing the cursor or focus. Use the same CLI and MCP server on macOS and Windows from Claude Code, Cursor, Codex, OpenClaw, and custom clients. Linux support is available as a pre-release backend while platform testing is still in progress.

macOS / Linux

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"Windows (PowerShell)

irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iexThen wire it into Claude Code as an MCP server and your agent can drive the desktop in the background:

claude mcp add --transport stdio cua-driver -- cua-driver mcpFull tool reference, architecture notes, and the optional agent skill pack live here: libs/cua-driver/README.md.

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

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

| Linux container | Linux VM | macOS | Windows | Android | BYOI (.qcow2, .iso) | |
|---|---|---|---|---|---|---|
| Cloud (cua.ai) | ✅ | ✅ | ✅ | ✅ | ✅ | 🔜 soon | 
| Local (QEMU) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 

**Get Started** | **Examples** | **API Reference**

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

Clone, install, and create base image

git clone https://github.com/trycua/cua && cd cua/cua-bench uv tool install -e . && cb image create linux-docker

Run benchmark with agent

cb run dataset datasets/cua-bench-basic --agent cua-agent --max-parallel 4

**Get Started** | **Partner With Us** | **Registry** | **CLI Reference**

Create and manage macOS/Linux VMs with near-native performance on Apple Silicon using Apple's Virtualization.Framework.

Install Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

Pull & start a macOS VM

lume run macos-sequoia-vanilla:latest ``` Get Started | FAQ | CLI Reference

Package Description
cua-driver Background computer-use agent for macOS, Windows, and Linux
cua-agent AI agent framework for computer-use tasks
cua-sandbox SDK for creating and controlling sandboxes
cua-computer-server Driver for UI interactions and code execution in sandboxes
cua-bench Benchmarks and RL environments for computer-use
lume macOS/Linux VM management on Apple Silicon
lumier Docker-compatible interface for Lume VMs

We welcome contributions! See our Contributing Guidelines for details.

MIT License — see LICENSE for details.

Third-party components have their own licenses:

Apple, macOS, Ubuntu, Canonical, and Microsoft are trademarks of their respective owners. This project is not affiliated with or endorsed by these companies.