cua
The unified Python SDK for Computer-Use Agents.
Installation
pip install cua
Quick Start
from cua import Sandbox, Image, ComputerAgent
# Ephemeral local sandbox with an agent
async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
await sb.shell.run("uname -a")
agent = ComputerAgent(model="anthropic/claude-sonnet-4-5", tools=[sb])
async for response in agent.run("Open the browser and go to example.com"):
print(response)
What's included
| Package | Import | Purpose |
|---|---|---|
cua-sandbox |
from cua import Sandbox, Image |
VM/container sandboxes |
cua-agent |
from cua import ComputerAgent |
LLM-driven computer-use agent |
cua-cli |
cua command |
CLI for managing sandboxes and images |
cua-agent[cloud] extras are included by default (OpenAI, Anthropic, Gemini API backends).
Extras
pip install cua[omni] # SOM-based visual grounding
pip install cua[uitars-mlx] # UiTars via MLX (Apple Silicon)
pip install cua[uitars-hf] # UiTars via HuggingFace
pip install cua[all] # Everything
Python Version
Requires Python 3.12 or 3.13. For Python 3.11, install cua-sandbox directly.
Telemetry
Cua collects anonymous usage statistics by default. Opt out with:
export CUA_TELEMETRY_ENABLED=false
Or per-instance:
async with Sandbox.ephemeral(Image.linux(), telemetry_enabled=False) as sb:
...
agent = ComputerAgent(..., telemetry_enabled=False)
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cua-0.1.6.tar.gz
(6.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
cua-0.1.6-py3-none-any.whl
(5.8 kB
view details)
File details
Details for the file cua-0.1.6.tar.gz.
File metadata
- Download URL: cua-0.1.6.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1d29f895ae76b56afba690cce5d832784212f78aa70bfe5d11f85181936c9977
|
|
| MD5 |
bdc19a1f61cfac4c0622e6d1d44ab083
|
|
| BLAKE2b-256 |
f9b57f003d3528db0daf7d64f12fc11c7b69d72fb56184890a1c2d75c1273cfb
|
File details
Details for the file cua-0.1.6-py3-none-any.whl.
File metadata
- Download URL: cua-0.1.6-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bb5022845f80a9224ad67ba61788b009a953b57df9415144e44b71f876d305b1
|
|
| MD5 |
d136b9dcd76cbf4ade513a70895dbfcc
|
|
| BLAKE2b-256 |
ea008bc75890a3f00c394f86044117798653bd6f756e622eb265c3594b17573c
|
