Cua
Open-source infrastructure for Computer-Use Agents. Sandboxes, SDKs, and benchmarks to train and evaluate AI agents that can control full desktops (macOS, Linux, Windows).
Install / Use
/learn @trycua/CuaREADME
Choose Your Path
<div align="center"> <table> <tr> <td align="center"> <a href="#cua---agentic-ui-automation--code-execution"> <picture> <source media="(prefers-color-scheme: dark)" srcset="img/card-cua-dark.png"> <source media="(prefers-color-scheme: light)" srcset="img/card-cua-light.png"> <img src="img/card-cua-light.png" alt="Cua" width="280"> </picture> </a> </td> <td align="center"> <a href="#cua-bench---benchmarks--rl-environments"> <picture> <source media="(prefers-color-scheme: dark)" srcset="img/card-cua-bench-dark.png"> <source media="(prefers-color-scheme: light)" srcset="img/card-cua-bench-light.png"> <img src="img/card-cua-bench-light.png" alt="Cua-Bench" width="280"> </picture> </a> </td> <td align="center"> <a href="#lume---macos-virtualization"> <picture> <source media="(prefers-color-scheme: dark)" srcset="img/card-lume-dark.png"> <source media="(prefers-color-scheme: light)" srcset="img/card-lume-light.png"> <img src="img/card-lume-light.png" alt="Lume" width="280"> </picture> </a> </td> </tr> <tr> <td colspan="3" align="center"> <a href="https://cua.ai/docs/cuabot/guide/getting-started/introduction"> <picture> <source media="(prefers-color-scheme: dark)" srcset="img/card-cua-bot-dark.png"> <source media="(prefers-color-scheme: light)" srcset="img/card-cua-bot-light.png"> <img src="img/card-cua-bot-light.png" alt="Cua Bot" width="888"> </picture> </a> </td> </tr> </table> </div>CuaBot - Co-op computer-use for any agent
<div align="center"> <img src="img/cuabot-screenshot.png" alt="cuabot screenshot" width="720"> </div>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 <x> <y> [button]
Built-in support for agent-browser and agent-device (iOS, Android) out of the box.
Get Started | Installation | First spotted at ClawCon
<img height="64" alt="cuaXclawdbot_nbg" src="https://github.com/user-attachments/assets/8b92237d-6e9b-4b3a-ae9a-b3560622ec1d" /> </div>Cua - Agentic UI Automation & Code Execution
Build agents that see screens, click buttons, and complete tasks autonomously. Run isolated code execution environments for AI coding assistants like Claude Code, Codex CLI, or OpenCode.
<!-- <img src="img/cua-architecture.png" alt="Cua Architecture" width="100%"> --># Requires Python 3.12 or 3.13
from computer import Computer
from agent import ComputerAgent
computer = Computer(os_type="linux", provider_type="cloud")
agent = ComputerAgent(model="anthropic/claude-sonnet-4-5-20250929", computer=computer)
async for result in agent.run([{"role": "user", "content": "Open Firefox and search for Cua"}]):
print(result)
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.
<!-- <img src="img/cua-bench-architecture.png" alt="Cua-Bench Architecture" width="100%"> --># Install and create base image
cd 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.
<!-- <img src="img/lume-architecture.png" alt="Lume Architecture" width="100%"> --># 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
Packages
| Package | Description | | --------------------------------------------------------------------------- | ---------------------------------------------------------- | | cuabot | Multi-agent computer-use sandbox CLI | | cua-agent | AI agent framework for computer-use tasks | | cua-computer | SDK for controlling desktop environments | | 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>