Give AI agents computers they can use.
Cua provides open-source desktop automation, isolated cloud desktops, local macOS VMs, and benchmarks for evaluating computer-use agents.
Try Cua Fleets now at run.cua.ai
Choose your path
|
||
|
|
|
cua is a free, open source ai development platforms project written in HTML and released under MIT. It has 22,799 GitHub stars, 1,587 forks and 926 open issues, and was last pushed 3 hours ago. On this registry it ranks #35 of 61 tracked projects in AI Development Platforms, with 5 head-to-head comparisons available. It gained 113 stars over the last 3 tracked days.
Cua is an MIT-licensed, open-source platform that gives AI agents computers to use, packaging desktop automation drivers, isolated cloud desktops, local macOS virtual machines, and benchmarks for training, evaluation, and data generation — it is aimed at developers and teams building computer-use agents who bring their own agent and model.
Cua lives in the computer-use agent ecosystem, alongside the agent hosts it connects to. The project supplies the computer and the automation tools while the user supplies the agent and the model. It bundles four distinct pieces: Cua Driver for inspecting and operating native desktop apps and browsers, Cua Fleets for isolated cloud desktops, Lume for local macOS and Linux virtual machines on Apple Silicon, and Cua Bench for creating and verifying simulated tasks. The README frames the target as Computer-Use 2.0, where an agent moves between code, APIs, and graphical interfaces within the same task rather than staying inside one modality.
The concrete problem is assembly. Without a platform of this kind, a team that wants an agent to click through LibreOffice Calc or drive an Inkscape canvas has to build its own desktop automation layer, its own sandbox lifecycle management, and its own evaluation harness before writing a single prompt. Cua replaces that ad hoc plumbing with a driver that speaks CLI, MCP, and typed SDKs, a Sandbox SDK that runs commands and captures screenshots inside a claimed desktop, and a benchmark surface for scoring the results. Local sandboxes and Fleets share the Sandbox SDK, so the same code shape carries from a developer laptop to pooled cloud capacity, though credentials, images, operations, and runtime requirements differ between the two.
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)", PowerShell irm https://cua.ai/driver/install.ps1 | iex, and /bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)".uname -a, saves a screenshot, and deletes the cloud resources.Install Cua Driver on macOS or Linux with /bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)" or on Windows with irm https://cua.ai/driver/install.ps1 | iex. Cua Fleets is available as a hosted service at run.cua.ai, and each path has a first-result tutorial covering credentials, permissions, dependencies, and cleanup.
No list of paid products that Cua replaces appears in the supplied facts, so it stands alone in this registry as an open-source computer-use platform rather than a swap-in for named commercial tools. Its overlap is with the agent hosts it integrates with — Claude Code, Codex, Cursor, and OpenClaw — which supply reasoning and driving while Cua supplies the machine and the automation surface.
Self-hosters who stay on Lume and local sandboxes must run VMs on their own Apple Silicon hardware and manage the local sandbox lifecycle themselves, while Fleet users must handle credentials and delete cloud resources, because pools can retain paid capacity after a claim ends. Anyone expecting a single uniform runtime should note that local sandboxes and Fleets differ in credentials, images, operations, and runtime requirements despite sharing the Sandbox SDK. The repository also carries 926 open issues, which is a signal of a fast-moving project rather than a settled one.
Give AI agents computers they can use.
Cua provides open-source desktop automation, isolated cloud desktops, local macOS VMs, and benchmarks for evaluating computer-use agents.
Try Cua Fleets now at run.cua.ai
|
||
|
|
|
You bring the agent and model. Cua provides the computer and automation tools. Computer-Use 2.0 describes an agent moving between code, APIs, and graphical interfaces within the same task.
Two Cua Driver sessions select cells in LibreOffice Calc and objects in Inkscape on an Omarchy desktop while a terminal stays in the foreground. Watch the 50-second demo, then explore Omarchy on Fleet.
https://github.com/user-attachments/assets/b4e5517c-d2db-4758-b4cf-07131b0753b2
Provision isolated cloud desktops at run.cua.ai. A Fleet maintains sandbox capacity; your code claims a desktop from a pool and uses the Sandbox SDK to run commands, capture screenshots, and interact with apps inside it.
Your first result: provision a Linux desktop, run uname -a, save a screenshot, and delete the cloud resources. The tutorial covers Fleet credentials, dependencies, and cleanup. Pools can retain paid capacity after a claim ends, so follow its cleanup steps.
Local sandboxes and Fleets share the Sandbox SDK, but credentials, images, operations, and runtime requirements differ. Use the runtime support reference to choose an environment. For your own hardware, see Manage local sandbox lifecycle.
Your first Cloud Fleet | Fleet overview | Sandbox SDK reference
Give your agent tools to inspect and operate native desktop apps and browsers on macOS, Windows, and Linux. Connect through the CLI, MCP, or typed SDKs. Background delivery lets agents work without moving your pointer or taking focus when the app and platform support it; see platform support for the boundaries.
macOS / Linux
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
Windows (PowerShell)
irm https://cua.ai/driver/install.ps1 | iex
Your first result: connect your agent, ask it to compute 6 × 7 in Calculator, and have it verify that the app displays 42. The tutorial covers platform setup, permissions, and agent connection.
Drive your first app | Installation | CLI Reference
Using Claude Code, Codex, Cursor, OpenClaw, or another agent? Find your integration. Source documentation and architecture notes live in libs/cua-driver/README.md.
Create and manage local macOS and Linux VMs on Apple Silicon using Apple's Virtualization.Framework.
/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
Your first result: create a vanilla macOS Tahoe VM from an Apple restore image, start it, and connect over SSH. The tutorial uses the Lume CLI directly and explains the unattended setup defaults.
Create your first Lume VM | Installation | CLI reference
Build computer-use tasks, evaluate agents, and export trajectories for training. Start with a simulated task that requires no VM, Docker, or model API key.
With Python 3.12 or 3.13 and uv installed:
uv tool install 'cua-bench[browser]'
uv tool run --from 'cua-bench[browser]' playwright install chromium
Your first result: create a small task, run its reference solution, and verify that its evaluator reports a reward of 1.0. Then try the same task yourself.
Build your first task | What is Cua-Bench? | CLI reference | Partner with us
If Cua supports your research, please cite the software:
@software{cua2025,
author = {{Cua AI, Inc.}},
title = {Cua},
year = {2025},
url = {https://github.com/trycua/cua},
license = {MIT}
}
For reproducibility, include the Cua release or commit used in your experiments. Citation metadata is also available in CITATION.cff.
We welcome contributions! See our Contributing Guidelines for details.
MIT License — see LICENSE for details.
Third-party components have their own licenses:
cua-agent[omni] includes ultralytics (AGPL-3.readme truncated — read the full docs on github
cua is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.
Scale computer-use 2.0 with open-source drivers, cross-OS fleets, and benchmarks for training, evaluation, and data generation.
cua is primarily written in HTML. Its source is publicly available at https://github.com/trycua/cua, and it has 22,799 GitHub stars.