cua-workspace

Choose Your Path

<table> <tr> <td colspan="3" align="center">

      ![Cua Drivers — background computer-use for any agent](https://raw.githubusercontent.com/trycua/cua/688f10767a2d0032a7e3b94e7371c85372e32ac9/img/card-cua-driver.gif)
    
  </td>
</tr>
<tr>
  <td align="center">
    
      ![Cua &amp; Cua Sandbox](https://raw.githubusercontent.com/trycua/cua/688f10767a2d0032a7e3b94e7371c85372e32ac9/img/card-cua-sandbox.gif)
    
  </td>
  <td align="center">
    
      ![Cua Bench](https://raw.githubusercontent.com/trycua/cua/688f10767a2d0032a7e3b94e7371c85372e32ac9/img/card-cua-bench.gif)
    
  </td>
  <td align="center">
    
      ![Lume](https://raw.githubusercontent.com/trycua/cua/688f10767a2d0032a7e3b94e7371c85372e32ac9/img/card-cua-lume.gif)
    
  </td>
</tr>

</table>

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

---

Cua Drivers - Background computer-use on macOS and Windows, with Linux pre-release

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://cua.ai/driver/install.sh)"

Windows (PowerShell)

irm https://cua.ai/driver/install.ps1 | iex

Then 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 mcp

Full tool reference, architecture notes, and the optional agent skill pack live here: libs/cua-driver/README.md.

---

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

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

Get Started | Examples | API Reference

---

Cua-Bench - Benchmarks & RL Environments

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

---

Lume - macOS Virtualization

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://cua.ai/lume/install.sh)"

# Create and start a vanilla macOS VM from an Apple restore image
curl -L "$(lume ipsw | tail -n 1)" -o ~/Downloads/macos-tahoe.ipsw
lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe
lume run macos-tahoe

The --unattended option prepares the installed guest offline. The built-in sequoia and tahoe presets create the lume user, enable SSH, configure autologin, and disable sleep and screen locking. The default credentials are lume / lume.

The Tahoe flow is E2E verified. Sequoia may still open the Accessibility step of Setup Assistant on its first display boot; see issue #2155.

Get Started | FAQ | CLI Reference

---

Packages

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

Resources

• Documentation — Guides, examples, and API reference
• Blog — Tutorials, updates, and research
• Discord — Community support and discussions
• GitHub Issues — Bug reports and feature requests

Contributing

We welcome contributions! See our Contributing Guidelines for details.

License

MIT License — see LICENSE for details.

Third-party components have their own licenses:

• Kasm (MIT)
• OmniParser (CC-BY-4.0)
• Optional cua-agent[omni] includes ultralytics (AGPL-3.0)

Trademarks

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

---

Thank you to all our GitHub Sponsors!