
Cua
โ 19,300from trycua
MCP server for the Computer-Use Agent (CUA), allowing you to run CUA through Claude Desktop or other MCP clients.
Choose Your Path
<div align="center"> <table> <tr> <td colspan="3" align="center"> <a href="#cua-drivers---background-computer-use-on-macos-and-windows-with-linux-pre-release"> <img src="img/card-cua-driver.gif" alt="Cua Drivers โ background computer-use for any agent" width="790"> </a> </td> </tr> <tr> <td align="center"> <a href="#cua---agent-ready-sandboxes-for-any-os"> <img src="img/card-cua-sandbox.gif" alt="Cua & Cua Sandbox" width="246"> </a> </td> <td align="center"> <a href="#cua-bench---benchmarks--rl-environments"> <img src="img/card-cua-bench.gif" alt="Cua Bench" width="246"> </a> </td> <td align="center"> <a href="#lume---macos-virtualization"> <img src="img/card-cua-lume.gif" alt="Lume" width="246"> </a> </td> </tr> </table> <p> <strong>Building your own agent?</strong> Start with <a href="#cua---agent-ready-sandboxes-for-any-os">Cua</a> ยท <strong>Giving a coding agent a computer?</strong> <a href="#cua-drivers---background-computer-use-on-macos-and-windows-with-linux-pre-release">Cua Drivers</a> ยท <strong>Evaluating or training models?</strong> <a href="#cua-bench---benchmarks--rl-environments">Cua Bench</a> ยท <strong>Need macOS VMs?</strong> <a href="#lume---macos-virtualization">Lume</a> </p> </div>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://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.
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 4Get 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://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
# Pull & start a macOS VM
lume run macos-sequoia-vanilla:latestGet 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.
<div align="center">
Thank you to all our GitHub Sponsors!
<img width="300" alt="coderabbit-cli" src="https://github.com/user-attachments/assets/23a98e38-7897-4043-8ef7-eb990520dccc" /> </div>This tool doesn't publish a standard install command โ the repository README on GitHub covers its setup.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.