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.

What is cua?

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.

What it is

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.

Key capabilities

  • Cua Fleets provisions isolated cloud desktops at run.cua.ai, where a Fleet maintains sandbox capacity and code claims a desktop from a pool.
  • The Sandbox SDK runs commands, captures screenshots, and interacts with applications inside a claimed desktop, with a runtime support reference for choosing an environment.
  • Cua Driver operates native desktop apps and browsers on macOS, Windows, and Linux, with background delivery that avoids moving the pointer or taking focus where the app and platform support it.
  • Driver connection paths include the CLI, MCP, and typed SDKs, with documented integrations for Claude Code, Codex, Cursor, and OpenClaw.
  • Lume creates and manages local macOS and Linux VMs on Apple Silicon using Apple's Virtualization.Framework, including a vanilla macOS Tahoe VM built from an Apple restore image.
  • Cua Bench creates and verifies simulated tasks for evaluation work.
  • Install scripts ship for each component: /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)".

Who uses it and how

  • Agent developers already working in Claude Code, Codex, Cursor, or OpenClaw connect their existing agent to Cua Driver and ask it to compute 6 × 7 in Calculator, then verify the app displays 42.
  • Teams needing parallel machines claim desktops from a Fleet pool and drive them through the Sandbox SDK, following the tutorial that provisions a Linux desktop, runs uname -a, saves a screenshot, and deletes the cloud resources.
  • Apple Silicon developers create a macOS Tahoe VM locally with the Lume CLI and connect over SSH, keeping the work off shared infrastructure.
  • Evaluation and data-generation groups use Cua Bench to construct and verify simulated tasks rather than scoring agents against ad hoc scripts.
  • Desktop-environment experiments run on cloud capacity, including the documented Omarchy on Fleet guide; the README demo shows two Cua Driver sessions selecting cells in LibreOffice Calc and objects in Inkscape while a terminal stays in the foreground.

Getting started

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.

How it compares

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.

When to use it — and when not to

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.

project readme (upstream, from github) — read inline

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

cua.ai Discord Twitter Documentation
trycua%2Fcua | Trendshift

Choose your path

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.

See Cua Driver in action

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


Cua Fleets

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


Cua Driver

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.


Lume

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


Cua Bench

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


Resources

Citation

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.

Contributing

We welcome contributions! See our Contributing Guidelines for details.

License

MIT License — see LICENSE for details.

Third-party components have their own licenses:

readme truncated — read the full docs on github

Frequently asked questions

Is cua free to use?

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.

What does cua do?

Scale computer-use 2.0 with open-source drivers, cross-OS fleets, and benchmarks for training, evaluation, and data generation.

What is cua written in?

cua is primarily written in HTML. Its source is publicly available at https://github.com/trycua/cua, and it has 22,799 GitHub stars.