Metadata-Version: 2.4
Name: cua
Version: 0.1.6
Summary: Cua — Computer-Use Agents: unified SDK meta-package
Project-URL: Homepage, https://github.com/trycua/cua
Project-URL: Documentation, https://docs.trycua.com
Project-URL: Repository, https://github.com/trycua/cua
Project-URL: Issues, https://github.com/trycua/cua/issues
Author-email: TryCua <hello@trycua.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,automation,computer-use,sandbox,vm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: <3.14,>=3.12
Requires-Dist: cua-agent[cloud]>=0.8.0
Requires-Dist: cua-cli>=0.1.8
Requires-Dist: cua-sandbox>=0.1.11
Provides-Extra: all
Requires-Dist: cua-agent[all]; extra == 'all'
Requires-Dist: cua-cli[all]; extra == 'all'
Provides-Extra: cloud
Requires-Dist: cua-agent[cloud]; extra == 'cloud'
Provides-Extra: omni
Requires-Dist: cua-agent[omni]; extra == 'omni'
Provides-Extra: ui
Requires-Dist: cua-agent[ui]; extra == 'ui'
Provides-Extra: uitars
Requires-Dist: cua-agent[uitars]; extra == 'uitars'
Provides-Extra: uitars-hf
Requires-Dist: cua-agent[uitars-hf]; extra == 'uitars-hf'
Provides-Extra: uitars-mlx
Requires-Dist: cua-agent[uitars-mlx]; extra == 'uitars-mlx'
Description-Content-Type: text/markdown

# cua

The unified Python SDK for Computer-Use Agents.

## Installation

```bash
pip install cua
```

## Quick Start

```python
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

```bash
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:

```bash
export CUA_TELEMETRY_ENABLED=false
```

Or per-instance:

```python
async with Sandbox.ephemeral(Image.linux(), telemetry_enabled=False) as sb:
    ...

agent = ComputerAgent(..., telemetry_enabled=False)
```

## Links

- [Documentation](https://docs.trycua.com)
- [GitHub](https://github.com/trycua/cua)
- [Issues](https://github.com/trycua/cua/issues)
