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).

agent ai-agent apple computer-use computer-use-agent containerization cua desktop-automation python

Why this rank:Strong adoptionRecent releaseHealthy release cadence

Description

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).

README

Build, benchmark, and deploy agents that use computers

Choose Your Path

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

CuaBot - Co-op computer-use for any agent

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

Cua-Bench - Benchmarks & RL Environments

Evaluate computer-use agents on OSWorld, ScreenSpot, Windows Arena, and custom tasks. Export trajectories for training.

# 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.

# 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-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.

Thank you to all our GitHub Sponsors!

Release History

Version	Changes	Urgency	Date
cua-driver-v0.2.0	## What's Changed * Bump cua-driver to v0.2.0 (d3f3b93) by @github-actions[bot] a6e8b598c5e9c311039d9c8784dd9b5bf208d95bb7c57d2e96b1dcac2769fd79 cua-driver-0.2.0-darwin-arm64.pkg.tar.gz 18c9fb20dcddfe703a55ed99aede4ca3d8fe5aee38afd20c3731acb10f6f4478 cua-driver-0.2.0-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" ``` > Supports Apple Silicon (arm64) and Intel (x86_64	High	5/17/2026
cua-driver-v0.1.9	## What's Changed * Bump cua-driver to v0.1.9 (041916d) by @github-actions[bot] * Fix non ARM binary 6416c5d1028c4ea404b546f8a9de41b817b87ff3e67e1800eb8df56dcf301b03 cua-driver-0.1.9-darwin-arm64.pkg.tar.gz f65081a40ae8e08b324b5dbe0132041680273097d15a10e57a63bbb228a13e59 cua-driver-0.1.9-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" ``` > Supports Appl	High	5/12/2026
cua-driver-v0.1.5	## What's Changed * Bump cua-driver to v0.1.5 (534304f) by @github-actions[bot] e817b659b7fb91269c059fe74dcaa7620ce39718c821ba55515578b8aebaf68d cua-driver-0.1.5-darwin-arm64.pkg.tar.gz 665f4eac42294c3690cf8200e2bd88d6044d6763826997d39dc0a418cd4b4a07 cua-driver-0.1.5-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" ```	High	5/6/2026
cua-driver-v0.1.2	## What's Changed * Bump cua-driver to v0.1.2 (91724df) by @github-actions[bot] 31de14c53ce85b2588aa0a5f40b3ad12874871c613374b101f58ce3778103e76 cua-driver-0.1.2-darwin-arm64.pkg.tar.gz bbe83a79f15d3da11b5de94cda414b70727b621b2d5319e6e2fa1a1137157654 cua-driver-0.1.2-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" ```	High	5/2/2026
cua-driver-v0.0.12	## What's Changed * Bump cua-driver to v0.0.12 (46dbcb4) by @github-actions[bot] 18a617f30b88729c654f83089f87a120ea2d2392397c3b32b9c45900f5c4112a cua-driver-0.0.12-darwin-arm64.pkg.tar.gz a7afecc7175a2d68e0a2e141120794497b8cd87504d21e445d4f477760251be4 cua-driver-0.0.12-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)" ```	High	4/27/2026
sandbox-v0.1.15	## What's Changed Maintenance release — dependency updates only.	High	4/22/2026
computer-server-v0.3.39	## What's Changed Maintenance release — dependency updates only.	High	4/21/2026
sandbox-v0.1.13	## What's Changed * fix(computer-server): accept SDK-supplied timeout in write_bytes ([#1347](https://github.com/trycua/cua/pull/1347)) (8e8a879) by @r33drichards	High	4/21/2026
computer-server-v0.3.38	## What's Changed Maintenance release — dependency updates only.	High	4/21/2026
computer-server-v0.3.37	## What's Changed Maintenance release — dependency updates only.	High	4/21/2026
computer-server-v0.3.36	## What's Changed Maintenance release — dependency updates only.	High	4/20/2026
cli-v0.1.11	## What's Changed Maintenance release — dependency updates only.	High	4/20/2026
computer-server-v0.3.35	## What's Changed Maintenance release — dependency updates only.	High	4/17/2026
computer-server-v0.3.34	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
cli-v0.1.10	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
bench-v0.2.10	Full Changelog: https://github.com/trycua/cua/compare/agent-v0.8.2...bench-v0.2.10	High	4/15/2026
agent-v0.8.2	## What's Changed * Fix stale @patch module paths in tests ([#1327](https://github.com/trycua/cua/pull/1327)) (63f554d) by @ddupont808 Dependencies: cua-computer 0.5.18, cua-som 0.1.4	High	4/15/2026
core-v0.3.1	## What's Changed * Fix stale @patch module paths in tests ([#1327](https://github.com/trycua/cua/pull/1327)) (63f554d) by @ddupont808	High	4/15/2026
computer-server-v0.3.33	## What's Changed * Rename agent/core packages to cua_agent/cua_core to avoid namespace collisions ([#1319](https://github.com/trycua/cua/pull/1319)) (f13f728) by @ddupont808	High	4/15/2026
cua-v0.1.6	# cua-cli v0.1.6 ## Installation ### Using install script (recommended) ```bash # For Linux/macOS curl -fsSL https://cua.ai/cli/install.sh \| sh # For Windows (PowerShell) irm https://cua.ai/cli/install.ps1 \| iex ``` ### Using npm/bun ```bash # Using bun bun add -g @trycua/cli # Or using npm npm install -g @trycua/cli ``` ### From source ```bash git clone -b cua-v0.1.6 https://github.com/trycua/cua.git cd cua/libs/typescript/cua-cli bun install bun link bun link	High	4/15/2026
computer-v0.5.18	## What's Changed * Rename agent/core packages to cua_agent/cua_core to avoid namespace collisions ([#1319](https://github.com/trycua/cua/pull/1319)) (f13f728) by @ddupont808 * feat: add cua meta-package and unify telemetry opt-out ([#1225](https://github.com/trycua/cua/pull/1225)) (d1bc076) by @ddupont808	High	4/15/2026
sandbox-v0.1.12	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
agent-v0.8.1	## What's Changed Maintenance release — dependency updates only. Dependencies: cua-computer 0.5.17, cua-som 0.1.4	High	4/15/2026
core-v0.3.0	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
core-v0.2.0	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
sandbox-apps-v0.1.1	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
sandbox-v0.1.10	## What's Changed Maintenance release — dependency updates only.	High	4/15/2026
sandbox-v0.1.9	## What's Changed * Improve sandbox cleanup and connection error handling ([#1292](https://github.com/trycua/cua/pull/1292)) (da9098b) by @r33drichards	High	4/10/2026
computer-server-v0.3.32	## What's Changed Maintenance release — dependency updates only.	High	4/3/2026
computer-server-v0.3.31	## What's Changed Maintenance release — dependency updates only.	Medium	4/3/2026
computer-server-v0.3.30	## What's Changed Added PyInstaller binary build step for faster installation on guest OSes when provisioning VMs	Medium	4/2/2026
computer-server-v0.3.29	## What's Changed * fix(computer-server): remove duplicate unconditional multitouch_gesture registration ([#1259](https://github.com/trycua/cua/pull/1259)) (f908389) by @ddupont808 * feat: add cua meta-package and unify telemetry opt-out ([#1225](https://github.com/trycua/cua/pull/1225)) (d1bc076) by @ddupont808	Medium	4/2/2026
sandbox-v0.1.8	## What's Changed Maintenance release — dependency updates only.	Medium	3/31/2026
sandbox-v0.1.7	## What's Changed Maintenance release — dependency updates only.	Medium	3/31/2026
sandbox-v0.1.6	## What's Changed Maintenance release — dependency updates only.	Medium	3/30/2026
sandbox-v0.1.5	## What's Changed Maintenance release — dependency updates only.	Medium	3/30/2026
sandbox-v0.1.4	## What's Changed * fix(cloud): prefer openjdk@17 over unversioned for pwa2apk Gradle builds (fc57391) by @ddupont808	Medium	3/30/2026
cua-v0.1.4	# cua-cli v0.1.4 ## Installation ### Using install script (recommended) ```bash # For Linux/macOS curl -fsSL https://cua.ai/cli/install.sh \| sh # For Windows (PowerShell) irm https://cua.ai/cli/install.ps1 \| iex ``` ### Using npm/bun ```bash # Using bun bun add -g @trycua/cli # Or using npm npm install -g @trycua/cli ``` ### From source ```bash git clone -b cua-v0.1.4 https://github.com/trycua/cua.git cd cua/libs/typescript/cua-cli bun install bun link bun link cua-cli ``` ## Release Asse	Medium	3/30/2026
sandbox-v0.1.3	## What's Changed Maintenance release — dependency updates only.	Medium	3/30/2026
bench-v0.2.8	## What's Changed * fix(cua-bench): --with flag silently skips reinstall when package version matches by @ddupont808 in https://github.com/trycua/cua/pull/1235 Full Changelog: https://github.com/trycua/cua/compare/lume-v0.3.9...bench-v0.2.8	Medium	3/27/2026
lume-v0.3.9	## What's Changed * Bump lume to v0.3.9 (08c07c7) by @github-actions[bot] cc9db0cec8f1d10040fe29271476c7be936948027a2d3356626cd519d0266677 lume-0.3.9-darwin-arm64.pkg.tar.gz 9951cff6a63e651b233dc94ce0eadcb83dfefcfd49a07bdd87a534ef192411ad lume-0.3.9-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/27/2026
lume-v0.3.8	## What's Changed * Bump lume to v0.3.8 (43785c8) by @github-actions[bot] f0b4c8d5a46d1f97a3de5b464d3e3ce890f9e007b3dc761686b06b5be9d0006a lume-0.3.8-darwin-arm64.pkg.tar.gz 2af8b00d3958f0a1078346a344aadff1dd40cf56efc687befc24531d7960c63d lume-0.3.8-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/27/2026
lume-v0.3.7	## What's Changed * Bump lume to v0.3.7 (59c30aa) by @github-actions[bot] 0c5b0e10bcadbf8bb008c002dd189d2e7484f03afb15a300c101e36f7ba76d7c lume-0.3.7-darwin-arm64.pkg.tar.gz 91b567bb8c1f6797183de7cd172c7d02fe94ea6123bc3eefce9a71a96d9ae6f0 lume-0.3.7-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/27/2026
cua-v0.1.3	# cua-cli v0.1.3 ## Installation ### Using install script (recommended) ```bash # For Linux/macOS curl -fsSL https://cua.ai/cli/install.sh \| sh # For Windows (PowerShell) irm https://cua.ai/cli/install.ps1 \| iex ``` ### Using npm/bun ```bash # Using bun bun add -g @trycua/cli # Or using npm npm install -g @trycua/cli ``` ### From source ```bash git clone -b cua-v0.1.3 https://github.com/trycua/cua.git cd cua/libs/typescript/cua-cli bun install bun link bun link cua-cli ``` ## Release Asse	Medium	3/26/2026
cua-v0.1.2	# cua-cli v0.1.2 ## Installation ### Using install script (recommended) ```bash # For Linux/macOS curl -fsSL https://cua.ai/cli/install.sh \| sh # For Windows (PowerShell) irm https://cua.ai/cli/install.ps1 \| iex ``` ### Using npm/bun ```bash # Using bun bun add -g @trycua/cli # Or using npm npm install -g @trycua/cli ``` ### From source ```bash git clone -b cua-v0.1.2 https://github.com/trycua/cua.git cd cua/libs/typescript/cua-cli bun install bun link bun link	Medium	3/26/2026
cua-v0.1.1	# cua-cli v0.1.1 ## Installation ### Using install script (recommended) ```bash # For Linux/macOS curl -fsSL https://cua.ai/cli/install.sh \| sh # For Windows (PowerShell) irm https://cua.ai/cli/install.ps1 \| iex ``` ### Using npm/bun ```bash # Using bun bun add -g @trycua/cli # Or using npm npm install -g @trycua/cli ``` ### From source ```bash git clone -b cua-v0.1.1 https://github.com/trycua/cua.git cd cua/libs/typescript/cua-cli bun install bun link bun link	Medium	3/26/2026
sandbox-v0.1.2	## What's Changed Maintenance release — dependency updates only.	Medium	3/26/2026
core-v0.1.19	## What's Changed * feat: add cua meta-package and unify telemetry opt-out ([#1225](https://github.com/trycua/cua/pull/1225)) (d1bc076) by @ddupont808 * fix(telemetry): suppress repeated init failure warnings ([#1109](https://github.com/trycua/cua/pull/1109)) (20aee61) by @sarinali	Medium	3/26/2026
sandbox-v0.1.1	## What's Changed Maintenance release — dependency updates only.	Medium	3/26/2026
computer-server-v0.3.28	## What's Changed Maintenance release — dependency updates only.	Medium	3/25/2026
agent-v0.7.38	## What's Changed Maintenance release — dependency updates only. Dependencies: cua-computer 0.5.17, cua-som 0.1.4	Medium	3/24/2026
lume-v0.3.4	## What's Changed * Bump lume to v0.3.4 (e221a32) by @github-actions[bot] 26b62a969e2f47cb051f7f41808c6f5334751a15eceb99dd62e35b53b18aabad lume-0.3.4-darwin-arm64.pkg.tar.gz 8bda2c083c707721524f024d524f078e05570f1dc8056254defa8164db5852a7 lume-0.3.4-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/24/2026
lume-v0.3.3	## What's Changed * Bump lume to v0.3.3 (6674d1b) by @github-actions[bot] eb3f318666965d7a343d4a0e689e764583be94948c5305c54ac7090870999802 lume-0.3.3-darwin-arm64.pkg.tar.gz 00850054d5bd2345196660d319c2eb554b74a6686eb5fbea04f230a35ddb74dc lume-0.3.3-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/24/2026
lume-v0.3.2	## What's Changed * Bump lume to v0.3.2 (63a7962) by @github-actions[bot] 827f07364feec99a922f4a53343688a00865a927bd8f99aefae9f2b768caf159 lume-0.3.2-darwin-arm64.pkg.tar.gz 31f9a08737a62cee5dd4d1d9850c5d6a396c3ef2733873b092516cdb574863d8 lume-0.3.2-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/23/2026
lume-v0.3.1	## What's Changed * Bump lume to v0.3.1 (5451137) by @github-actions[bot] ef490c725a5a77902ba8c4f57da34166cb8283c9eaca717844a347eb2a24755f lume-0.3.1-darwin-arm64.pkg.tar.gz 2e8d43e5b1e7f7d2ca5ae6164540c471d258a3fc0777ab091bc015a244951669 lume-0.3.1-darwin-arm64.tar.gz ### Installation with script ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" ```	Medium	3/23/2026
computer-server-v0.3.27	## What's Changed Maintenance release — dependency updates only.	Medium	3/23/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

E2BOpen-source, secure environment with real-world tools for enterprise-grade agents.e2b@2.28.0

OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.docker/egress/v1.0.13

contemplative-agentA self-improving AI agent that learns from experience. Runs entirely on a local 9B model. Security by absence — dangerous capabilities were never built.v2.5.0

awesome-lark-botsProvide open-source AI bots for Lark to automate tasks like brainstorming, project planning, content creation, and monitoring within a secure chat interface.main@2026-06-04

OpenClaw-TurboSimplify AI agent deployment and management with OpenClaw-Turbo’s secure, intuitive interface optimized for Linux and Chinese language support.main@2026-06-04

More in Security

clineAutonomous coding agent right in your IDE, capable of creating/editing files, executing commands, using the browser, and more with your permission every step of the way.

E2BOpen-source, secure environment with real-world tools for enterprise-grade agents.

OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.

vm0the easiest way to run natural language-described workflows automatically