trycua / 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).
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing trycua/cua in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Summary (README)
PreviewChoose 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>