Skip to content

armgit / cua

Public Imported from GitHub
0

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

docs: update imports and install commands to use cua metapackage (#1228)

ddupont547752b6faf4
diff --git a/.github/workflows/claude-auto-fix.yml b/.github/workflows/claude-auto-fix.yml
index eb436939a5..f978d156fb 100644
--- a/.github/workflows/claude-auto-fix.yml
+++ b/.github/workflows/claude-auto-fix.yml
@@ -222,7 +222,7 @@ jobs:
if: steps.context.outputs.has_failed_run == 'true'
run: |
cat > /tmp/claude-prompt.txt << 'PROMPT_EOF'
- You are Claude, an AI assistant that fixes CI failures in the CUA (Computer Use Agent) monorepo.
+ You are Claude, an AI assistant that fixes CI failures in the Cua (Computer Use Agent) monorepo.
CONTEXT:
- Repository: ${{ github.repository }}
diff --git a/README.md b/README.md
index fecad86c1a..cb2b416a8e 100644
--- a/README.md
+++ b/README.md
@@ -73,11 +73,15 @@
Build agents that see screens, click buttons, and complete tasks autonomously. One API for any VM or container image — cloud or local.
+```sh
+pip install cua
+```
+
<!-- <img src="img/cua-architecture.png" alt="Cua Architecture" width="100%"> -->
```python
-# Requires Python 3.12 or 3.13
-from cua_sandbox import Sandbox, Image
+# 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()
diff --git a/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx b/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx
index 2699287647..853e968113 100644
--- a/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx
+++ b/docs/content/docs/cua/examples/ai-models/gemini-complex-ui-navigation.mdx
@@ -95,8 +95,7 @@ Install the required packages for OmniParser and Gemini 3:
Create a `requirements.txt` file:
```text
-cua-agent
-cua-sandbox
+cua
cua-som # OmniParser for GUI element detection
litellm>=1.0.0
python-dotenv>=1.0.0
@@ -152,8 +151,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -298,8 +296,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -421,8 +418,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
diff --git a/docs/content/docs/cua/examples/automation/form-filling.mdx b/docs/content/docs/cua/examples/automation/form-filling.mdx
index 1efce19cc2..7bc49c966c 100644
--- a/docs/content/docs/cua/examples/automation/form-filling.mdx
+++ b/docs/content/docs/cua/examples/automation/form-filling.mdx
@@ -25,8 +25,7 @@ First, install the required dependencies:
Create a `requirements.txt` file:
```text
-cua-agent
-cua-sandbox
+cua
python-dotenv>=1.0.0
```
@@ -67,8 +66,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -173,8 +171,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -272,8 +269,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -372,8 +368,7 @@ import os
import signal
import traceback
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
diff --git a/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx b/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx
index 1d198c31a8..ea5493e595 100644
--- a/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx
+++ b/docs/content/docs/cua/examples/automation/post-event-contact-export.mdx
@@ -61,8 +61,7 @@ First, install the required dependencies:
Create a `requirements.txt` file:
```text
-cua-agent
-cua-sandbox
+cua
python-dotenv>=1.0.0
```
@@ -134,8 +133,7 @@ import signal
import traceback
from datetime import datetime
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
diff --git a/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx b/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx
index 693f53718a..956242141b 100644
--- a/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx
+++ b/docs/content/docs/cua/examples/platform-specific/windows-app-behind-vpn.mdx
@@ -60,8 +60,7 @@ Install the required dependencies:
Create a `requirements.txt` file:
```text
-cua-agent
-cua-sandbox
+cua
python-dotenv>=1.0.0
```
@@ -151,8 +150,7 @@ Create a Python file (e.g., `hr_automation.py`):
import asyncio
import logging
import os
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -263,8 +261,7 @@ if __name__ == "__main__":
import asyncio
import logging
import os
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
@@ -342,8 +339,7 @@ if __name__ == "__main__":
import asyncio
import logging
import os
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from dotenv import load_dotenv
logging.basicConfig(level=logging.INFO)
diff --git a/docs/content/docs/cua/examples/sandboxes/android.mdx b/docs/content/docs/cua/examples/sandboxes/android.mdx
index ccf8298bef..b7dd4e9dd5 100644
--- a/docs/content/docs/cua/examples/sandboxes/android.mdx
+++ b/docs/content/docs/cua/examples/sandboxes/android.mdx
@@ -19,7 +19,7 @@ Android sandboxes expose the `sb.mobile` interface for touch input, gestures, an
```python
# source: examples/sandboxes/test_android_cloud_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -49,7 +49,7 @@ asyncio.run(main())
```python
# source: examples/sandboxes/test_android_local_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
diff --git a/docs/content/docs/cua/examples/sandboxes/custom-images.mdx b/docs/content/docs/cua/examples/sandboxes/custom-images.mdx
index 54d8938280..5062e68e7b 100644
--- a/docs/content/docs/cua/examples/sandboxes/custom-images.mdx
+++ b/docs/content/docs/cua/examples/sandboxes/custom-images.mdx
@@ -22,8 +22,8 @@ Pull a Linux OCI VM image from `ghcr.io` and run it locally with `TartRuntime`.
```python
# source: examples/sandboxes/test_linux_local_registry_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
-from cua_sandbox.runtime import TartRuntime
+from cua import Image, Sandbox
+from cua.runtime import TartRuntime
async def main():
@@ -53,7 +53,7 @@ Pull a macOS OCI image. The SDK reads the OCI manifest to auto-select Lume as th
```python
# source: examples/sandboxes/test_macos_local_registry_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -81,7 +81,7 @@ Run any local disk image directly. Supported formats: `.qcow2`, `.vhdx`, `.raw`,
```python
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
async with Sandbox.ephemeral(
@@ -113,8 +113,8 @@ Run the standard [OSWorld](https://os-world.github.io/) Ubuntu image using the O
```python
# source: examples/sandboxes/test_linux_local_osworld_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
-from cua_sandbox.runtime import QEMURuntime
+from cua import Image, Sandbox
+from cua.runtime import QEMURuntime
OSWORLD_IMAGE = (
"https://huggingface.co/datasets/xlangai/ubuntu_osworld/resolve/main/Ubuntu.qcow2.zip"
diff --git a/docs/content/docs/cua/examples/sandboxes/linux.mdx b/docs/content/docs/cua/examples/sandboxes/linux.mdx
index 54d6cf9c79..76ecaad986 100644
--- a/docs/content/docs/cua/examples/sandboxes/linux.mdx
+++ b/docs/content/docs/cua/examples/sandboxes/linux.mdx
@@ -29,7 +29,7 @@ Linux is available as either a lightweight **container** (Docker-backed, fast st
```python
# source: examples/sandboxes/test_linux_cloud_container.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -55,7 +55,7 @@ asyncio.run(main())
```python
# source: examples/sandboxes/test_linux_cloud_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -81,7 +81,7 @@ asyncio.run(main())
```python
# source: examples/sandboxes/test_linux_local_container.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -108,7 +108,7 @@ asyncio.run(main())
```python
# source: examples/sandboxes/test_linux_local_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
diff --git a/docs/content/docs/cua/examples/sandboxes/macos.mdx b/docs/content/docs/cua/examples/sandboxes/macos.mdx
index 062fe271a4..832db7b8d1 100644
--- a/docs/content/docs/cua/examples/sandboxes/macos.mdx
+++ b/docs/content/docs/cua/examples/sandboxes/macos.mdx
@@ -22,7 +22,7 @@ macOS sandboxes are always VMs — either on Cua Cloud or locally via [Lume](htt
```python
# source: examples/sandboxes/test_macos_cloud_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -48,7 +48,7 @@ asyncio.run(main())
```python
# source: examples/sandboxes/test_macos_local_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -77,7 +77,7 @@ Pull a macOS image directly from the `ghcr.io/trycua` registry. The SDK reads th
```python
# source: examples/sandboxes/test_macos_local_registry_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
diff --git a/docs/content/docs/cua/examples/sandboxes/windows.mdx b/docs/content/docs/cua/examples/sandboxes/windows.mdx
index 34f7231891..8147e6f113 100644
--- a/docs/content/docs/cua/examples/sandboxes/windows.mdx
+++ b/docs/content/docs/cua/examples/sandboxes/windows.mdx
@@ -19,7 +19,7 @@ Windows sandboxes run as full VMs. Cloud Windows works on any host OS. Local Win
```python
# source: examples/sandboxes/test_windows_cloud_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
@@ -47,7 +47,7 @@ The SDK automatically selects Hyper-V on Windows hosts with Hyper-V available, o
```python
# source: examples/sandboxes/test_windows_local_vm.py
import asyncio
-from cua_sandbox import Image, Sandbox
+from cua import Image, Sandbox
async def main():
diff --git a/docs/content/docs/cua/guide/advanced/chat-history.mdx b/docs/content/docs/cua/guide/advanced/chat-history.mdx
index d5f77fd5e2..0ec4a84daf 100644
--- a/docs/content/docs/cua/guide/advanced/chat-history.mdx
+++ b/docs/content/docs/cua/guide/advanced/chat-history.mdx
@@ -10,8 +10,7 @@ description: Managing conversation history for multi-turn agent interactions
Pass a message history to continue from previous context:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
agent = ComputerAgent(
diff --git a/docs/content/docs/cua/guide/advanced/composed-models.mdx b/docs/content/docs/cua/guide/advanced/composed-models.mdx
index 094ecef84e..b389a0be06 100644
--- a/docs/content/docs/cua/guide/advanced/composed-models.mdx
+++ b/docs/content/docs/cua/guide/advanced/composed-models.mdx
@@ -10,8 +10,7 @@ Some models excel at **grounding** (finding UI elements) but can't reason about
Use the `+` syntax to combine a grounding model with a planning model:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
# Format: grounding_model+planning_model
diff --git a/docs/content/docs/cua/guide/advanced/custom-tools.mdx b/docs/content/docs/cua/guide/advanced/custom-tools.mdx
index e9530a01da..2b58aa0e5f 100644
--- a/docs/content/docs/cua/guide/advanced/custom-tools.mdx
+++ b/docs/content/docs/cua/guide/advanced/custom-tools.mdx
@@ -47,7 +47,7 @@ General models like Claude work with any tools you provide - no auto-wrapping oc
The easiest way to add a tool is to pass a function with a docstring:
```python
-from agent import ComputerAgent
+from cua import ComputerAgent
def calculate(a: int, b: int) -> int:
"""Calculate the sum of two integers"""
@@ -73,7 +73,7 @@ The agent can now call `calculate` and `get_weather` alongside computer actions.
For tools that should run inside the sandbox rather than on your host machine, use the `@sandboxed` decorator:
```python
-from cua_sandbox.helpers import sandboxed
+from cua import sandboxed
@sandboxed()
def read_file(path: str) -> str:
@@ -105,7 +105,7 @@ See [Sandboxed Python](/cua/guide/advanced/sandboxed-python) for more details.
For more control over tool schema and behavior, extend `BaseTool`:
```python
-from agent.tools import BaseTool, register_tool
+from cua.tools import BaseTool, register_tool
from typing import Union
@register_tool("database_query")
@@ -202,9 +202,9 @@ Sync functions are automatically run in a thread pool to avoid blocking.
Pass multiple tools of different types:
```python
-from agent import ComputerAgent
-from agent.tools import BrowserTool
-from cua_sandbox.helpers import sandboxed
+from cua import ComputerAgent
+from cua.tools import BrowserTool
+from cua import sandboxed
# Built-in tool
browser = BrowserTool(interface=computer)
@@ -235,7 +235,7 @@ The agent decides which tool to use based on the task.
Tools can raise exceptions, which are passed back to the model:
```python
-from agent.tools import ToolError
+from cua.tools import ToolError
def divide(a: float, b: float) -> float:
"""Divide a by b"""
@@ -251,8 +251,7 @@ The model sees the error message and can adjust its approach.
Here's a complete example with file management tools:
```python
-from agent import ComputerAgent
-from cua_sandbox.helpers import sandboxed
+from cua import ComputerAgent, sandboxed
@sandboxed()
def list_files(directory: str = ".") -> list:
diff --git a/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx b/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx
index c49156bb85..983b66e721 100644
--- a/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx
+++ b/docs/content/docs/cua/guide/advanced/demonstration-guided-skills.mdx
@@ -43,7 +43,7 @@ Read the SKILL.md file and prefix it to your prompt:
```python
from pathlib import Path
-from agent import ComputerAgent
+from cua import ComputerAgent
# Load the skill prompt from SKILL.md
skill_path = Path.home() / ".cua/skills/flight-booking/SKILL.md"
diff --git a/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx b/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx
index 0f120eccb3..43815eeff1 100644
--- a/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx
+++ b/docs/content/docs/cua/guide/advanced/human-in-the-loop.mdx
@@ -20,8 +20,7 @@ This opens a UI that shows pending completions. Select a completion to take cont
Use `human/human` as the model:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
agent = ComputerAgent(
diff --git a/docs/content/docs/cua/guide/advanced/interactive-shell.mdx b/docs/content/docs/cua/guide/advanced/interactive-shell.mdx
index 190216370c..b7dc2b0844 100644
--- a/docs/content/docs/cua/guide/advanced/interactive-shell.mdx
+++ b/docs/content/docs/cua/guide/advanced/interactive-shell.mdx
@@ -29,7 +29,7 @@ The shell is fully interactive — arrow keys, tab completion, and `Ctrl+C` all
## Python SDK
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.create(provider_type="docker", name="my-container") as c:
handle = await c.pty.create(
diff --git a/docs/content/docs/cua/guide/advanced/local-computer-server.mdx b/docs/content/docs/cua/guide/advanced/local-computer-server.mdx
index 6ec7248522..bd9efb0fd5 100644
--- a/docs/content/docs/cua/guide/advanced/local-computer-server.mdx
+++ b/docs/content/docs/cua/guide/advanced/local-computer-server.mdx
@@ -24,7 +24,7 @@ Or install dependencies manually:
```bash
pip install uvicorn fastapi
-pip install cua-sandbox
+pip install cua
```
## Starting the Server
@@ -54,7 +54,7 @@ The server exposes endpoints for screenshots, mouse/keyboard input, and other co
Use `use_host_computer_server=True` to connect to a running computer server:
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
# Connect to local computer server
async with Sandbox.create(use_host_computer_server=True) as computer:
@@ -82,8 +82,7 @@ async with Sandbox.create(
Run agents against your desktop:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.create(use_host_computer_server=True) as computer:
agent = ComputerAgent(
diff --git a/docs/content/docs/cua/guide/advanced/prompt-caching.mdx b/docs/content/docs/cua/guide/advanced/prompt-caching.mdx
index a8dd0c2b79..d21607f780 100644
--- a/docs/content/docs/cua/guide/advanced/prompt-caching.mdx
+++ b/docs/content/docs/cua/guide/advanced/prompt-caching.mdx
@@ -10,8 +10,7 @@ description: Reduce costs and latency with provider-specific prompt caching
Set `use_prompt_caching=True` when creating your agent:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
diff --git a/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx b/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx
index 9d98cec6b6..7b10703bfc 100644
--- a/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx
+++ b/docs/content/docs/cua/guide/advanced/sandboxed-python.mdx
@@ -17,7 +17,7 @@ Sometimes you don't want to rely on UI automation or shell commands—you just w
Here's the basic pattern:
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.ephemeral(Image.linux()) as computer:
# First, install any packages you need
@@ -70,8 +70,7 @@ result = await computer.venv_cmd("data_env", "python /path/to/script.py")
For cleaner code, use the decorator to mark functions for remote execution:
```python
-from cua_sandbox import Sandbox, Image
-from cua_sandbox.helpers import sandboxed
+from cua import Sandbox, Image, sandboxed
async with Sandbox.ephemeral(Image.linux()) as computer:
await computer.venv_install("api_env", ["requests"])
diff --git a/docs/content/docs/cua/guide/advanced/telemetry.mdx b/docs/content/docs/cua/guide/advanced/telemetry.mdx
index fd1cc665f6..11e06ad389 100644
--- a/docs/content/docs/cua/guide/advanced/telemetry.mdx
+++ b/docs/content/docs/cua/guide/advanced/telemetry.mdx
@@ -47,8 +47,7 @@ export CUA_TELEMETRY_ENABLED=false
Disable on individual objects:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
# Disable for Computer
async with Sandbox.ephemeral(Image.linux(), telemetry_enabled=False) as computer:
diff --git a/docs/content/docs/cua/guide/advanced/tracing.mdx b/docs/content/docs/cua/guide/advanced/tracing.mdx
index 835c128c9f..01daa6ea44 100644
--- a/docs/content/docs/cua/guide/advanced/tracing.mdx
+++ b/docs/content/docs/cua/guide/advanced/tracing.mdx
@@ -10,7 +10,7 @@ The **Tracing API** records everything that happens on a Computer—screenshots,
Start and stop tracing around any computer operations:
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.ephemeral(Image.linux()) as computer:
# Start tracing
@@ -147,8 +147,7 @@ Metadata appears in the trace alongside events, making it easy to correlate acti
Tracing works alongside ComputerAgent—you get both agent-level information and detailed computer interaction logs:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
# Start tracing before agent runs
diff --git a/docs/content/docs/cua/guide/advanced/trajectories.mdx b/docs/content/docs/cua/guide/advanced/trajectories.mdx
index 261f200399..bca5f664cc 100644
--- a/docs/content/docs/cua/guide/advanced/trajectories.mdx
+++ b/docs/content/docs/cua/guide/advanced/trajectories.mdx
@@ -10,7 +10,7 @@ description: Save and analyze agent execution for debugging and training
Enable trajectory saving with the `trajectory_dir` parameter:
```python
-from agent import ComputerAgent
+from cua import ComputerAgent
agent = ComputerAgent(
model="anthropic/claude-sonnet-4-5-20250929",
@@ -163,7 +163,7 @@ Common issues trajectories help identify:
## Example: Saving and Analyzing
```python
-from agent import ComputerAgent
+from cua import ComputerAgent
from pathlib import Path
import json
diff --git a/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx b/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx
index 382e219337..0fa73fb6d6 100644
--- a/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx
+++ b/docs/content/docs/cua/guide/fundamentals/agent-loops.mdx
@@ -17,9 +17,9 @@ An **agent loop** runs iteratively until a task is complete:
To run an agent loop simply do:
```python
-from agent import ComputerAgent
+from cua import ComputerAgent
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def take_screenshot():
diff --git a/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx b/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx
index 6243dbc844..9b3a9382fa 100644
--- a/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx
+++ b/docs/content/docs/cua/guide/fundamentals/browser-tool.mdx
@@ -24,9 +24,8 @@ Use the standard Computer tool when:
The Browser Tool uses Playwright under the hood to control the browser:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
-from agent.tools import BrowserTool
+from cua import Sandbox, Image, ComputerAgent
+from cua.tools import BrowserTool
# Create a computer instance
async with Sandbox.ephemeral(Image.linux()) as computer:
@@ -85,7 +84,7 @@ await agent.run("Go back to the previous page")
You can also call Browser Tool actions programmatically without an agent:
```python
-from agent.tools import BrowserTool
+from cua.tools import BrowserTool
browser = BrowserTool(interface=computer)
@@ -140,9 +139,8 @@ The `pause_and_memorize_fact` action lets the agent store information for later
Here's a complete example automating a web form:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
-from agent.tools import BrowserTool
+from cua import Sandbox, Image, ComputerAgent
+from cua.tools import BrowserTool
async with Sandbox.ephemeral(Image.linux()) as computer:
browser = BrowserTool(interface=computer)
diff --git a/docs/content/docs/cua/guide/fundamentals/callbacks.mdx b/docs/content/docs/cua/guide/fundamentals/callbacks.mdx
index e267a6db73..13bc488858 100644
--- a/docs/content/docs/cua/guide/fundamentals/callbacks.mdx
+++ b/docs/content/docs/cua/guide/fundamentals/callbacks.mdx
@@ -10,8 +10,8 @@ description: Hook into agent lifecycle events for logging, cost tracking, and mo
Pass callbacks when creating your agent:
```python
-from agent import ComputerAgent
-from agent.callbacks import LoggingCallback, BudgetManagerCallback
+from cua import ComputerAgent
+from cua.callbacks import LoggingCallback, BudgetManagerCallback
import logging
agent = ComputerAgent(
@@ -45,7 +45,7 @@ agent = ComputerAgent(
Logs agent lifecycle events with configurable verbosity:
```python
-from agent.callbacks import LoggingCallback
+from cua.callbacks import LoggingCallback
import logging
agent = ComputerAgent(
@@ -69,7 +69,7 @@ Logs include API calls, computer actions, text responses, and usage statistics.
Tracks costs and stops execution when a budget limit is reached:
```python
-from agent.callbacks import BudgetManagerCallback
+from cua.callbacks import BudgetManagerCallback
agent = ComputerAgent(
model="...",
@@ -96,7 +96,7 @@ When `raise_error=True`, the agent raises `BudgetExceededError` instead of stopp
Limits how many screenshots are kept in the message history to prevent context overflow:
```python
-from agent.callbacks import ImageRetentionCallback
+from cua.callbacks import ImageRetentionCallback
agent = ComputerAgent(
model="...",
@@ -119,7 +119,7 @@ Older screenshots are removed along with their associated computer call items.
Saves complete agent conversations for debugging and analysis:
```python
-from agent.callbacks import TrajectorySaverCallback
+from cua.callbacks import TrajectorySaverCallback
agent = ComputerAgent(
model="...",
@@ -146,7 +146,7 @@ See [Trajectories](/cua/guide/advanced/trajectories) for details on the saved fo
Prepends custom instructions to every LLM call:
```python
-from agent.callbacks import PromptInstructionsCallback
+from cua.callbacks import PromptInstructionsCallback
agent = ComputerAgent(
model="...",
diff --git a/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx b/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx
index 3dabad5596..6da44f92b9 100644
--- a/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx
+++ b/docs/content/docs/cua/guide/fundamentals/cua-vlm-router.mdx
@@ -8,8 +8,7 @@ Instead of deploying and managing computer-use vision language models yourself o
## Setup
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
agent = ComputerAgent(
diff --git a/docs/content/docs/cua/guide/fundamentals/vlms.mdx b/docs/content/docs/cua/guide/fundamentals/vlms.mdx
index 13402036c2..6788bf2efd 100644
--- a/docs/content/docs/cua/guide/fundamentals/vlms.mdx
+++ b/docs/content/docs/cua/guide/fundamentals/vlms.mdx
@@ -10,8 +10,7 @@ A **Vision Language Model (VLM)** is the AI that powers your computer-use agent.
Specify the model when creating your agent:
```python
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async with Sandbox.ephemeral(Image.linux()) as computer:
agent = ComputerAgent(
@@ -64,7 +63,7 @@ export OPENAI_API_KEY="your-key"
Gemini 2.5 Computer-Use is optimized for **browser automation** rather than full desktop control. Use it with the [Browser Tool](/cua/guide/fundamentals/browser-tool) for web-based tasks:
```python
-from agent.tools import BrowserTool
+from cua.tools import BrowserTool
# Use with BrowserTool for web automation
agent = ComputerAgent(model="gemini-2.5-computer-use-preview-10-2025", tools=[browser])
@@ -81,7 +80,7 @@ For full desktop computer-use, consider Anthropic Claude or OpenAI instead.
Fara is Microsoft's browser automation model, available via Azure ML. Like Gemini 2.5, it's designed for web tasks and works with the [Browser Tool](/cua/guide/fundamentals/browser-tool):
```python
-from agent.tools import BrowserTool
+from cua.tools import BrowserTool
agent = ComputerAgent(
model="azure_ml/Fara-7B",
diff --git a/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx b/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx
index 3ba81bbdf4..0c79ef23bb 100644
--- a/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx
+++ b/docs/content/docs/cua/guide/get-started/migrating-from-computer-sdk.mdx
@@ -22,7 +22,7 @@ The new Sandbox SDK (`cua-sandbox`) unifies everything: one package creates the
pip install cua-computer
# After
-pip install cua-sandbox
+pip install cua
```
## Import and instantiation
@@ -43,7 +43,7 @@ await computer.run()
**After:**
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
# Ephemeral (create + destroy automatically)
async with Sandbox.ephemeral(Image.linux()) as sb:
@@ -84,7 +84,7 @@ The old SDK used a `provider_type` string to select the runtime. The new SDK use
| `"docker"` with QEMU Android | `Sandbox.ephemeral(Image.android(), local=True)` |
| `"lume"` | `Sandbox.ephemeral(Image.macos(), local=True)` |
| `"windows_sandbox"` | `Sandbox.ephemeral(Image.windows(), local=True)` |
-| `use_host_computer_server=True` | `from cua_sandbox import Localhost; Localhost.connect()` |
+| `use_host_computer_server=True` | `from cua import Localhost; Localhost.connect()` |
## Before and after — full example
@@ -116,7 +116,7 @@ asyncio.run(main())
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
diff --git a/docs/content/docs/cua/guide/get-started/quickstart.mdx b/docs/content/docs/cua/guide/get-started/quickstart.mdx
index 3629be418a..192d4d8a84 100644
--- a/docs/content/docs/cua/guide/get-started/quickstart.mdx
+++ b/docs/content/docs/cua/guide/get-started/quickstart.mdx
@@ -17,7 +17,7 @@ This guide gets you from zero to a working computer-use agent.
## 1. Install
```bash
-pip install cua-sandbox "cua-agent[all]"
+pip install cua
```
## 2. Hello World
@@ -26,7 +26,7 @@ Create `hello.py`:
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def main():
# local=True uses Docker — no API key needed
@@ -62,8 +62,7 @@ Then create `agent.py`:
```python
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async def main():
async with Sandbox.ephemeral(Image.linux()) as sb:
@@ -90,8 +89,7 @@ Call `get_display_url(share=True)` to get a shareable browser link to the live d
```python
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async def main():
async with Sandbox.ephemeral(Image.linux()) as sb:
diff --git a/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx b/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx
index ea4645552c..ffa619bec8 100644
--- a/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx
+++ b/docs/content/docs/cua/guide/get-started/using-agent-sdk.mdx
@@ -20,12 +20,12 @@ Cua Agent Framework provides:
<Tab value="Python">
**Using uv (recommended):**
```bash
- uv pip install "cua-agent[all]"
+ uv pip install cua
```
**Or with pip:**
```bash
- pip install "cua-agent[all]"
+ pip install cua
```
</Tab>
@@ -49,8 +49,7 @@ Use Cua's inference API to access multiple model providers with a single API key
```python
import os
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
os.environ["CUA_API_KEY"] = "sk_cua-api01_..."
@@ -100,8 +99,7 @@ Use your own API keys from model providers like Anthropic, OpenAI, or others.
```python
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
# Set your provider API key
import os
diff --git a/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx b/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx
index 18178a9794..562589d05d 100644
--- a/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx
+++ b/docs/content/docs/cua/guide/get-started/using-sandbox-sdk.mdx
@@ -15,13 +15,13 @@ The Sandbox SDK (`cua-sandbox`) lets you create and control sandboxes — take s
## Installation
```bash
-pip install cua-sandbox
+pip install cua
```
Or with uv:
```bash
-uv pip install cua-sandbox
+uv pip install cua
```
## Create a Sandbox
@@ -30,7 +30,7 @@ uv pip install cua-sandbox
<Tab value="Cloud Linux Container">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.linux()) as sb:
@@ -48,7 +48,7 @@ uv pip install cua-sandbox
<Tab value="Cloud Linux VM">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.linux(kind="vm")) as sb:
@@ -63,10 +63,46 @@ uv pip install cua-sandbox
```
Requires `CUA_API_KEY` environment variable.
</Tab>
+ <Tab value="Cloud macOS">
+ ```python
+ import asyncio
+ from cua import Sandbox, Image
+
+ async def main():
+ async with Sandbox.ephemeral(Image.macos()) as sb:
+ result = await sb.shell.run("sw_vers")
+ print(result.stdout)
+
+ screenshot = await sb.screenshot()
+ with open("screenshot.png", "wb") as f:
+ f.write(screenshot)
+
+ asyncio.run(main())
+ ```
+ Requires `CUA_API_KEY` environment variable. Works on any host OS — no Mac needed.
+ </Tab>
+ <Tab value="Cloud Windows">
+ ```python
+ import asyncio
+ from cua import Sandbox, Image
+
+ async def main():
+ async with Sandbox.ephemeral(Image.windows()) as sb:
+ result = await sb.shell.run("ver")
+ print(result.stdout)
+
+ screenshot = await sb.screenshot()
+ with open("screenshot.png", "wb") as f:
+ f.write(screenshot)
+
+ asyncio.run(main())
+ ```
+ Requires `CUA_API_KEY` environment variable.
+ </Tab>
<Tab value="Local Linux">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
@@ -84,7 +120,7 @@ uv pip install cua-sandbox
<Tab value="Local macOS (Lume)">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.macos(), local=True) as sb:
@@ -102,7 +138,7 @@ uv pip install cua-sandbox
<Tab value="Local Windows">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.windows(), local=True) as sb:
@@ -120,7 +156,7 @@ uv pip install cua-sandbox
<Tab value="Local Android">
```python
import asyncio
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.android(), local=True) as sb:
@@ -181,7 +217,7 @@ For long-running workflows, create a named sandbox instead of ephemeral:
# → {"name": "my-sandbox-name", "status": "ready"}
# Connect from Python
-from cua_sandbox import Sandbox
+from cua import Sandbox
async with Sandbox.connect("my-sandbox-name", local=True) as sb:
await sb.shell.run("echo connected")
@@ -190,7 +226,7 @@ async with Sandbox.connect("my-sandbox-name", local=True) as sb:
Or manage the full lifecycle in Python:
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
# Create and keep running
sb = await Sandbox.create(Image.linux(), local=True)
diff --git a/docs/content/docs/cua/guide/get-started/what-is-cua.mdx b/docs/content/docs/cua/guide/get-started/what-is-cua.mdx
index be2532209f..c351fc1894 100644
--- a/docs/content/docs/cua/guide/get-started/what-is-cua.mdx
+++ b/docs/content/docs/cua/guide/get-started/what-is-cua.mdx
@@ -7,8 +7,7 @@ Cua lets you spin up isolated desktop environments — Linux, macOS, Windows, An
```python
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async def main():
async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
@@ -30,7 +29,7 @@ asyncio.run(main())
## Install
```bash
-pip install cua-sandbox "cua-agent[all]"
+pip install cua
```
No account needed to run locally with Docker. For cloud sandboxes and hosted models, get a free API key at [cua.ai](https://cua.ai/signin).
diff --git a/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx b/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx
index 1c9f6ba12a..8502b9ebed 100644
--- a/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx
+++ b/docs/content/docs/cua/guide/integrations/benchmarks/index.mdx
@@ -22,7 +22,7 @@ git clone https://github.com/trycua/cua
cd libs/python/agent/benchmarks
# Install dependencies
-pip install "cua-agent[all]"
+pip install cua
# Run a benchmark
python ss-v2.py
diff --git a/docs/content/docs/cua/guide/integrations/hud.mdx b/docs/content/docs/cua/guide/integrations/hud.mdx
index 021dac9748..54dd48bfba 100644
--- a/docs/content/docs/cua/guide/integrations/hud.mdx
+++ b/docs/content/docs/cua/guide/integrations/hud.mdx
@@ -14,7 +14,7 @@ The HUD integration allows an agent to be benchmarked using the [HUD framework](
First, install the required package:
```bash
-pip install "cua-agent[hud]"
+pip install "cua[hud]"
## or install hud-python directly
# pip install hud-python==0.4.12
```
diff --git a/docs/content/docs/cua/guide/integrations/laminar.mdx b/docs/content/docs/cua/guide/integrations/laminar.mdx
index 0b3f6ac757..d877636bd1 100644
--- a/docs/content/docs/cua/guide/integrations/laminar.mdx
+++ b/docs/content/docs/cua/guide/integrations/laminar.mdx
@@ -23,8 +23,7 @@ import os
import litellm
-from agent import ComputerAgent
-from cua_sandbox import Sandbox, Image
+from cua import ComputerAgent, Sandbox, Image
from lmnr import Laminar, LaminarLiteLLMCallback # [!code highlight]
Laminar.initialize() # [!code highlight]
diff --git a/docs/content/docs/cua/guide/sandbox/images.mdx b/docs/content/docs/cua/guide/sandbox/images.mdx
index 7385191614..5142d113d1 100644
--- a/docs/content/docs/cua/guide/sandbox/images.mdx
+++ b/docs/content/docs/cua/guide/sandbox/images.mdx
@@ -10,7 +10,7 @@ An `Image` describes the operating system and software environment your sandbox
## Built-in images
```python
-from cua_sandbox import Image
+from cua import Image
Image.linux() # Ubuntu 24.04 container (default)
Image.linux(kind="vm") # Ubuntu 24.04 full VM
diff --git a/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx b/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx
index 190216370c..b7dc2b0844 100644
--- a/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx
+++ b/docs/content/docs/cua/guide/sandbox/interactive-shell.mdx
@@ -29,7 +29,7 @@ The shell is fully interactive — arrow keys, tab completion, and `Ctrl+C` all
## Python SDK
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.create(provider_type="docker", name="my-container") as c:
handle = await c.pty.create(
diff --git a/docs/content/docs/cua/guide/sandbox/lifecycle.mdx b/docs/content/docs/cua/guide/sandbox/lifecycle.mdx
index accc171459..888c51fc6c 100644
--- a/docs/content/docs/cua/guide/sandbox/lifecycle.mdx
+++ b/docs/content/docs/cua/guide/sandbox/lifecycle.mdx
@@ -30,7 +30,7 @@ Use this for scripts, CI jobs, and any task where you want the sandbox to disapp
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def main():
async with Sandbox.ephemeral(Image.linux()) as sb:
@@ -51,7 +51,7 @@ Use this when you need the sandbox to outlive your Python process, or when you w
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def main():
# Create and get back a handle — sandbox keeps running after this script exits
diff --git a/docs/content/docs/cua/guide/sandbox/scale-out.mdx b/docs/content/docs/cua/guide/sandbox/scale-out.mdx
index 41cc8ea059..8d66adbab0 100644
--- a/docs/content/docs/cua/guide/sandbox/scale-out.mdx
+++ b/docs/content/docs/cua/guide/sandbox/scale-out.mdx
@@ -13,7 +13,7 @@ Because `Sandbox.ephemeral` and `Sandbox.create` are async, you can run many san
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def run_task(task: str) -> str:
async with Sandbox.ephemeral(Image.linux()) as sb:
@@ -34,7 +34,7 @@ If you have a large batch, use a semaphore to cap the number of sandboxes runnin
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
MAX_CONCURRENT = 5
@@ -59,7 +59,7 @@ For dynamic workloads where tasks arrive at runtime, use `asyncio.Queue`:
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def worker(queue: asyncio.Queue, worker_id: int):
while True:
@@ -97,7 +97,7 @@ A common pattern for visual testing — take screenshots across multiple environ
```python
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def screenshot_env(image: Image, label: str) -> tuple[str, bytes]:
async with Sandbox.ephemeral(image) as sb:
@@ -127,8 +127,7 @@ Run the same task across multiple sandboxes to compare model outputs or increase
```python
import asyncio
-from cua_sandbox import Sandbox, Image
-from agent import ComputerAgent
+from cua import Sandbox, Image, ComputerAgent
async def run_agent(task: str, run_id: int) -> dict:
async with Sandbox.ephemeral(Image.linux()) as sb:
diff --git a/docs/content/docs/cua/guide/sandbox/secrets.mdx b/docs/content/docs/cua/guide/sandbox/secrets.mdx
index e7d4673138..7771174362 100644
--- a/docs/content/docs/cua/guide/sandbox/secrets.mdx
+++ b/docs/content/docs/cua/guide/sandbox/secrets.mdx
@@ -26,7 +26,7 @@ CUA_API_KEY=sk_cua-...
from dotenv import load_dotenv
load_dotenv()
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
```
You can also pass the key explicitly if you manage it programmatically:
@@ -45,7 +45,7 @@ The recommended pattern is to read secrets from the host environment and inject
```python
import os
import asyncio
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async def main():
db_url = os.environ["DATABASE_URL"] # read from host
@@ -78,7 +78,7 @@ result = await sb.shell.run(script)
Use `.env()` on the `Image` builder for configuration that isn't sensitive — feature flags, log levels, app settings:
```python
-from cua_sandbox import Image
+from cua import Image
img = (
Image.linux()
diff --git a/docs/content/docs/cua/guide/sandbox/tunneling.mdx b/docs/content/docs/cua/guide/sandbox/tunneling.mdx
index b067e6582d..d2694ed3d5 100644
--- a/docs/content/docs/cua/guide/sandbox/tunneling.mdx
+++ b/docs/content/docs/cua/guide/sandbox/tunneling.mdx
@@ -10,7 +10,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
## Basic usage
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.ephemeral(Image.linux()) as sb:
# Start something inside the sandbox
@@ -73,7 +73,7 @@ async with sb.tunnel.forward("chrome_devtools_remote") as t:
Forward the DevTools port from a sandbox browser to use CDP tools locally:
```python
-from cua_sandbox import Sandbox, Image
+from cua import Sandbox, Image
async with Sandbox.ephemeral(Image.linux()) as sb:
await sb.shell.run("google-chrome --remote-debugging-port=9222 --headless &")
diff --git a/docs/content/docs/cua/reference/agent-sdk/changelog.mdx b/docs/content/docs/cua/reference/agent-sdk/changelog.mdx
index 7a4019b688..ac90a87067 100644
--- a/docs/content/docs/cua/reference/agent-sdk/changelog.mdx
+++ b/docs/content/docs/cua/reference/agent-sdk/changelog.mdx
@@ -188,7 +188,7 @@ New Contributors
**Dependencies:** cua-computer: latest, cua-som: latest
- Stream MCP responses instead of buffering by @YeIIcw in https://github.com/trycua/cua/pull/427
-- Add support for Gemini CUA model by @ddupont808 in https://github.com/trycua/cua/pull/472
+- Add support for Gemini Cua model by @ddupont808 in https://github.com/trycua/cua/pull/472
- Add support for Claude Haiku 4.5 by @ddupont808 in https://github.com/trycua/cua/pull/474
- Add bump2version configuration for all Python packages by @r33drichards in https://github.com/trycua/cua/pull/463
diff --git a/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx b/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx
index 9dcc6f85bf..f507faa81f 100644
--- a/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx
+++ b/docs/content/docs/cua/reference/agent-sdk/v0.3/api.mdx
@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
<span className="text-sm text-fd-muted-foreground">pip install cua-agent==0.3.2</span>
</div>
-CUA (Computer Use) Agent for AI-driven computer interaction.
+Cua (Computer Use) Agent for AI-driven computer interaction.
## Classes
diff --git a/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx b/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx
index d28c71bf7e..871a4d41d2 100644
--- a/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx
+++ b/docs/content/docs/cua/reference/agent-sdk/v0.6/api.mdx
@@ -91,7 +91,7 @@ def open(self, port: Optional[int] = None)
Start the playground server and open it in the browser.
This method starts a local HTTP server that exposes the /responses endpoint
-and automatically opens the CUA playground interface in the default browser.
+and automatically opens the Cua playground interface in the default browser.
Args:
port: Port to run the server on. If None, finds an available port automatically.
diff --git a/docs/content/docs/cua/reference/cli/index.mdx b/docs/content/docs/cua/reference/cli/index.mdx
index f7fa87bf0b..06fb35b9f4 100644
--- a/docs/content/docs/cua/reference/cli/index.mdx
+++ b/docs/content/docs/cua/reference/cli/index.mdx
@@ -21,13 +21,13 @@ import { VersionHeader } from '@/components/version-selector';
packageName="cua-cli"
/>
-CUA CLI - Unified command-line interface for Computer-Use Agents.
+Cua CLI - Unified command-line interface for Computer-Use Agents.
---
## main
-Main entry point for CUA CLI.
+Main entry point for Cua CLI.
### print_error
@@ -57,7 +57,7 @@ Main entry point for the CLI.
## auth
-Authentication module for CUA CLI.
+Authentication module for Cua CLI.
---
@@ -172,7 +172,7 @@ Save an API key to the credential store.
## utils
-Utility modules for CUA CLI.
+Utility modules for Cua CLI.
### run_async
diff --git a/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx b/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx
index b4f1973cfe..eb129dc5da 100644
--- a/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx
+++ b/docs/content/docs/cua/reference/computer-sdk/v0.3/api.mdx
@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
<span className="text-sm text-fd-muted-foreground">pip install cua-computer==0.3.7</span>
</div>
-CUA Computer Interface for cross-platform computer control.
+Cua Computer Interface for cross-platform computer control.
## Classes
diff --git a/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx b/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx
index 9a865a16d4..a32d7d2f8d 100644
--- a/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx
+++ b/docs/content/docs/cua/reference/computer-sdk/v0.4/api.mdx
@@ -23,7 +23,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
<span className="text-sm text-fd-muted-foreground">pip install cua-computer==0.4.19</span>
</div>
-CUA Computer Interface for cross-platform computer control.
+Cua Computer Interface for cross-platform computer control.
## Classes
diff --git a/docs/content/docs/cua/reference/sandbox-sdk/index.mdx b/docs/content/docs/cua/reference/sandbox-sdk/index.mdx
index 4f8f39af93..47d1d30dfc 100644
--- a/docs/content/docs/cua/reference/sandbox-sdk/index.mdx
+++ b/docs/content/docs/cua/reference/sandbox-sdk/index.mdx
@@ -25,7 +25,7 @@ cua-sandbox — ephemeral and persistent sandboxed computer environments.
Usage::
- import cua_sandbox as cua
+ import cua
# Configure API access
cua.configure(api_key="sk-...")
@@ -46,15 +46,15 @@ Usage::
| [`Localhost`](#localhost) | Direct host control via cua_auto — no sandboxing. |
| [`Sandbox`](#sandbox) | A sandboxed computer environment. |
| [`SandboxInfo`](#sandboxinfo) | Metadata for a local or cloud sandbox. |
-| [`CloudTransport`](#cloudtransport) | Transport that provisions / connects to a CUA cloud VM. |
+| [`CloudTransport`](#cloudtransport) | Transport that provisions / connects to a Cua cloud VM. |
## Functions
| Function | Description |
|----------|-------------|
-| [`login`](#login) | Open the CUA login page in a browser and store credentials. |
+| [`login`](#login) | Open the Cua login page in a browser and store credentials. |
| [`whoami`](#whoami) | Return info about the authenticated user. |
-| [`configure`](#configure) | Set global configuration for the CUA SDK. |
+| [`configure`](#configure) | Set global configuration for the Cua SDK. |
---
@@ -499,7 +499,7 @@ automatically.
|------|------|-------------|
| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). |
| `name` | `Any` | Optional name to assign to the sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `local` | `Any` | Use a local runtime instead of cloud. |
| `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). |
| `cpu` | `Any` | Number of CPUs for the cloud sandbox. |
@@ -532,7 +532,7 @@ manager, ``disconnect()`` is called on exit — the sandbox keeps running.
| Name | Type | Description |
|------|------|-------------|
| `name` | `Any` | Name of the existing sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `ws_url` | `Any` | WebSocket URL for a remote computer-server. |
| `http_url` | `Any` | HTTP base URL for a remote computer-server. |
| `container_name` | `Any` | Container name for cloud auth (HTTP transport). |
@@ -565,7 +565,7 @@ Create an ephemeral sandbox that is automatically destroyed on exit.
|------|------|-------------|
| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). |
| `name` | `Any` | Optional name to assign to the sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `local` | `Any` | Use a local runtime instead of cloud. |
| `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). |
| `cpu` | `Any` | Number of CPUs for the cloud sandbox. |
@@ -594,7 +594,7 @@ List running and suspended sandboxes.
| Name | Type | Description |
|------|------|-------------|
| `local` | `Any` | If True, list local sandboxes (Lume, Docker, QEMU). If False, list cloud sandboxes. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
#### Sandbox.get_info
@@ -610,7 +610,7 @@ Get metadata for a specific sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, look up in local runtimes. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
#### Sandbox.suspend
@@ -631,7 +631,7 @@ For cloud: calls POST /v1/vms/\{name\}/stop.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, operate on a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
#### Sandbox.resume
@@ -647,7 +647,7 @@ Resume a suspended sandbox and return a connected Sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, resume a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
**Returns:** A connected Sandbox ready to use.
@@ -665,7 +665,7 @@ Restart a sandbox (suspend then resume) and return a connected Sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, restart a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
**Returns:** A connected Sandbox ready to use.
@@ -686,7 +686,7 @@ For cloud sandboxes, calls DELETE /v1/vms/\{name\}.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, delete a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
---
@@ -719,7 +719,7 @@ SandboxInfo(self, name: str, status: str, source: str, os_type: Optional[str] =
*Inherits from: Transport*
-Transport that provisions / connects to a CUA cloud VM.
+Transport that provisions / connects to a Cua cloud VM.
### Constructor
@@ -815,7 +815,7 @@ async def get_display_url(self, share: bool = False) -> str
def login(base_url: Optional[str] = None) -> None
```
-Open the CUA login page in a browser and store credentials.
+Open the Cua login page in a browser and store credentials.
This initiates a Clerk-based browser authentication flow.
The user completes login in their browser, and the resulting
@@ -829,7 +829,7 @@ def whoami(api_key: Optional[str] = None) -> Dict[str, Any]
Return info about the authenticated user.
-**Returns:** Dict with user info (id, email, etc.) from the CUA API.
+**Returns:** Dict with user info (id, email, etc.) from the Cua API.
## configure
@@ -837,14 +837,14 @@ Return info about the authenticated user.
def configure(api_key: Optional[str] = None, base_url: Optional[str] = None) -> None
```
-Set global configuration for the CUA SDK.
+Set global configuration for the Cua SDK.
**Parameters:**
| Name | Type | Description |
|------|------|-------------|
| `api_key` | `Any` | API key for cloud sandboxes. |
-| `base_url` | `Any` | Base URL for the CUA cloud API. |
+| `base_url` | `Any` | Base URL for the Cua cloud API. |
---
@@ -856,7 +856,7 @@ All cua_auto calls are sync; async wrappers use asyncio.to_thread().
Usage::
- from cua_sandbox import localhost
+ from cua import localhost
async with localhost() as host:
await host.mouse.click(100, 200)
@@ -1011,7 +1011,7 @@ as interface objects backed by a Transport.
Usage::
- from cua_sandbox import Sandbox, Image
+ from cua import Sandbox, Image
# Provision a new persistent sandbox
sb = await Sandbox.create(Image.desktop("ubuntu"))
@@ -1372,7 +1372,7 @@ Return a URL to view this sandbox's display.
*Inherits from: Transport*
-Transport that provisions / connects to a CUA cloud VM.
+Transport that provisions / connects to a Cua cloud VM.
### Constructor
@@ -1812,7 +1812,7 @@ automatically.
|------|------|-------------|
| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). |
| `name` | `Any` | Optional name to assign to the sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `local` | `Any` | Use a local runtime instead of cloud. |
| `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). |
| `cpu` | `Any` | Number of CPUs for the cloud sandbox. |
@@ -1845,7 +1845,7 @@ manager, ``disconnect()`` is called on exit — the sandbox keeps running.
| Name | Type | Description |
|------|------|-------------|
| `name` | `Any` | Name of the existing sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `ws_url` | `Any` | WebSocket URL for a remote computer-server. |
| `http_url` | `Any` | HTTP base URL for a remote computer-server. |
| `container_name` | `Any` | Container name for cloud auth (HTTP transport). |
@@ -1878,7 +1878,7 @@ Create an ephemeral sandbox that is automatically destroyed on exit.
|------|------|-------------|
| `image` | `Any` | Image to run (e.g. ``Image.desktop("ubuntu")``). |
| `name` | `Any` | Optional name to assign to the sandbox. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
| `local` | `Any` | Use a local runtime instead of cloud. |
| `runtime` | `Any` | Explicit runtime backend (DockerRuntime, QEMURuntime, etc.). |
| `cpu` | `Any` | Number of CPUs for the cloud sandbox. |
@@ -1907,7 +1907,7 @@ List running and suspended sandboxes.
| Name | Type | Description |
|------|------|-------------|
| `local` | `Any` | If True, list local sandboxes (Lume, Docker, QEMU). If False, list cloud sandboxes. |
-| `api_key` | `Any` | CUA API key for cloud sandboxes. |
+| `api_key` | `Any` | Cua API key for cloud sandboxes. |
#### Sandbox.get_info
@@ -1923,7 +1923,7 @@ Get metadata for a specific sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, look up in local runtimes. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
#### Sandbox.suspend
@@ -1944,7 +1944,7 @@ For cloud: calls POST /v1/vms/\{name\}/stop.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, operate on a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
#### Sandbox.resume
@@ -1960,7 +1960,7 @@ Resume a suspended sandbox and return a connected Sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, resume a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
**Returns:** A connected Sandbox ready to use.
@@ -1978,7 +1978,7 @@ Restart a sandbox (suspend then resume) and return a connected Sandbox.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, restart a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
**Returns:** A connected Sandbox ready to use.
@@ -1999,7 +1999,7 @@ For cloud sandboxes, calls DELETE /v1/vms/\{name\}.
|------|------|-------------|
| `name` | `Any` | Sandbox name. |
| `local` | `Any` | If True, delete a local sandbox. |
-| `api_key` | `Any` | CUA API key for cloud. |
+| `api_key` | `Any` | Cua API key for cloud. |
### sandbox
@@ -2024,7 +2024,7 @@ for cloud API or cloud-init consumption.
Usage::
- from cua_sandbox import Image
+ from cua import Image
img = (
Image.linux("ubuntu", "24.04")
diff --git a/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx b/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx
index c975eebc8c..584b7e0a42 100644
--- a/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx
+++ b/docs/content/docs/cua/reference/sandbox-sdk/interfaces.mdx
@@ -292,7 +292,7 @@ await sb.window.close()
`Localhost` gives you the same interface as `Sandbox` but operates directly on the machine running Python, with no sandbox involved. Useful for local automation or testing.
```python
-from cua_sandbox import Localhost
+from cua import Localhost
async with Localhost.connect() as host:
result = await host.shell.run("echo hello")
diff --git a/docs/content/docs/cua/vibe-coding-mcp.mdx b/docs/content/docs/cua/vibe-coding-mcp.mdx
index 55db779904..e4e06a74d9 100644
--- a/docs/content/docs/cua/vibe-coding-mcp.mdx
+++ b/docs/content/docs/cua/vibe-coding-mcp.mdx
@@ -1,14 +1,14 @@
---
title: Vibe Coding MCP
-description: Connect your AI agents to CUA documentation and source code
+description: Connect your AI agents to Cua documentation and source code
---
-The CUA MCP server equips AI coding agents with deep knowledge about CUA's APIs, patterns, source code, and best practices. When connected to your development environment, it enables AI assistants to:
+The Cua MCP server equips AI coding agents with deep knowledge about Cua's APIs, patterns, source code, and best practices. When connected to your development environment, it enables AI assistants to:
- **Search documentation** with full-text and semantic search
- **Explore source code** across all versions and components
- **Generate accurate code** with context from the actual codebase
-- **Understand CUA internals** by querying versioned implementations
+- **Understand Cua internals** by querying versioned implementations
## Server URL
@@ -41,12 +41,12 @@ The MCP server exposes four read-only query tools:
1. Press `Shift+Command+J` (Mac) or `Shift+Ctrl+J` (Windows/Linux) to open settings
2. Find "MCP Tools" in the left sidebar
3. Click "Add Custom MCP" to open `mcp.json`
-4. Add the CUA MCP server configuration:
+4. Add the Cua MCP server configuration:
```json
{
"mcpServers": {
- "CUA MCP": {
+ "Cua MCP": {
"url": "https://vk-mcp.cua.ai/mcp"
}
}
@@ -89,7 +89,7 @@ claude mcp remove cua-mcp -s local
1. Go to **Settings** > **Connectors**
2. Click **Add custom connector**
3. Enter the following:
- - **Name**: `CUA MCP`
+ - **Name**: `Cua MCP`
- **URL**: `https://vk-mcp.cua.ai/mcp`
4. Click **Add**
@@ -112,7 +112,7 @@ Configuration file location:
3. Select **MCP Servers**
4. Click **Remote Servers** tab
5. Enter:
- - **Server Name**: `CUA MCP`
+ - **Server Name**: `Cua MCP`
- **Server URL**: `https://vk-mcp.cua.ai/mcp`
6. Click **Add Server**
@@ -124,7 +124,7 @@ Configuration file location:
```json
{
"servers": {
- "CUA MCP": {
+ "Cua MCP": {
"url": "https://vk-mcp.cua.ai/mcp"
}
}
@@ -146,7 +146,7 @@ https://vk-mcp.cua.ai/mcp
```json
{
"servers": {
- "CUA MCP": {
+ "Cua MCP": {
"url": "https://vk-mcp.cua.ai/mcp"
}
}
diff --git a/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx b/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx
index 70ca0d2924..037f8fdca5 100644
--- a/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx
+++ b/docs/content/docs/cuabench/guide/fundamentals/agent-traces.mdx
@@ -12,7 +12,7 @@ After running a task with an agent, traces are saved to `~/.local/share/cua-benc
```
~/.local/share/cua-bench/runs/96d41b51/slack_env_v0/
├── run.log # Execution logs
-├── task_0_agent_logs/ # CUA Agent SDK trajectories (if using cua-agent)
+├── task_0_agent_logs/ # Cua Agent SDK trajectories (if using cua-agent)
│ └── trajectories/
│ └── 2026-01-07_claudesonnet4_210819_2a23/
│ ├── metadata.json # Agent turns, model responses, usage
diff --git a/docs/content/docs/cuabench/guide/getting-started/installation.mdx b/docs/content/docs/cuabench/guide/getting-started/installation.mdx
index 4c7e3b0281..06a0939625 100644
--- a/docs/content/docs/cuabench/guide/getting-started/installation.mdx
+++ b/docs/content/docs/cuabench/guide/getting-started/installation.mdx
@@ -84,7 +84,7 @@ Commands:
trace View and manage trace datasets
dataset Manage datasets and build from outputs
prune Clean up cua-bench data, images, and Docker resources
- login Authenticate with CUA Cloud to get API token
+ login Authenticate with Cua Cloud to get API token
Options:
-h, --help Show this help message and exit
diff --git a/docs/content/docs/cuabench/reference/api.mdx b/docs/content/docs/cuabench/reference/api.mdx
index 4258fd13bd..0814b9caed 100644
--- a/docs/content/docs/cuabench/reference/api.mdx
+++ b/docs/content/docs/cuabench/reference/api.mdx
@@ -3795,7 +3795,7 @@ Failure mode for agent execution.
*Inherits from: BaseAgent*
-Agent implementation using the CUA Computer Agent SDK.
+Agent implementation using the Cua Computer Agent SDK.
### Constructor
@@ -3824,7 +3824,7 @@ def name() -> str
async def perform_task(self, task_description: str, session: DesktopSession, logging_dir: Path | None = None, tracer = None) -> AgentResult
```
-Perform a task using the CUA Computer Agent.
+Perform a task using the Cua Computer Agent.
**Parameters:**
@@ -4127,7 +4127,7 @@ Sessions module for async container management.
*Inherits from: ABC*
-Base class for session providers (Docker, CUA Cloud, etc.).
+Base class for session providers (Docker, Cua Cloud, etc.).
### Methods
@@ -4226,7 +4226,7 @@ Create a session provider for the specified provider.
| Name | Type | Description |
|------|------|-------------|
-| `provider_name` | `Any` | Name of the provider: - "local": Run locally using Docker (webtop) or QEMU/KVM (winarena) - "cloud": Run on CUA Cloud (GCP Batch for webtop, Azure Batch for winarena) - "docker": (legacy) Alias for "local" |
+| `provider_name` | `Any` | Name of the provider: - "local": Run locally using Docker (webtop) or QEMU/KVM (winarena) - "cloud": Run on Cua Cloud (GCP Batch for webtop, Azure Batch for winarena) - "docker": (legacy) Alias for "local" |
| `env_type` | `Any` | Optional environment type hint ("webtop" or "winarena"). Used by local provider to select appropriate backend. |
**Returns:** SessionProvider instance
@@ -4721,7 +4721,7 @@ Telemetry module for cua-bench.
This module provides analytics for tracking feature usage, user workflows,
and system performance. All telemetry is routed through cua-core's PostHog
-infrastructure for consistency across the CUA ecosystem.
+infrastructure for consistency across the Cua ecosystem.
Events tracked:
- Tier 1 (Core): command_invoked, task_execution_started, task_evaluation_completed, batch_job_started
diff --git a/docs/content/docs/lume/reference/changelog.mdx b/docs/content/docs/lume/reference/changelog.mdx
index abfec79aa1..21af0b5d85 100644
--- a/docs/content/docs/lume/reference/changelog.mdx
+++ b/docs/content/docs/lume/reference/changelog.mdx
@@ -210,10 +210,10 @@ Maintenance release.
### v0.2.23 (2025-12-23)
- Update README badges with sky/emerald colors and larger logo by @f-trycua in https://github.com/trycua/cua/pull/641
-- Add QEMU Ubuntu 22.04 template with CUA computer-server support by @synacktraa in https://github.com/trycua/cua/pull/622
-- Add QEMU Windows 11 template with CUA computer-server support by @synacktraa in https://github.com/trycua/cua/pull/551
+- Add QEMU Ubuntu 22.04 template with Cua computer-server support by @synacktraa in https://github.com/trycua/cua/pull/622
+- Add QEMU Windows 11 template with Cua computer-server support by @synacktraa in https://github.com/trycua/cua/pull/551
- docs: update intro page with hero image and Geist font by @f-trycua in https://github.com/trycua/cua/pull/642
-- docs: expand CUA description with screenshot-VLM-action loop by @f-trycua in https://github.com/trycua/cua/pull/643
+- docs: expand Cua description with screenshot-VLM-action loop by @f-trycua in https://github.com/trycua/cua/pull/643
- F trycua/docs hero image by @f-trycua in https://github.com/trycua/cua/pull/644
- Introduce cua-bench-ui submodules (webview API, configurable ports, improved python RPC) by @ddupont808 in https://github.com/trycua/cua/pull/645
- Replace PyQt6 with PySide6 by @ddupont808 in https://github.com/trycua/cua/pull/646
diff --git a/libs/python/cua/cua/callbacks.py b/libs/python/cua/cua/callbacks.py
new file mode 100644
index 0000000000..660b701d1a
--- /dev/null
+++ b/libs/python/cua/cua/callbacks.py
@@ -0,0 +1,32 @@
+"""cua.callbacks — agent lifecycle callback handlers.
+
+Usage::
+
+ from cua.callbacks import LoggingCallback, BudgetManagerCallback
+"""
+
+from agent.callbacks import (
+ AsyncCallbackHandler,
+ BudgetManagerCallback,
+ ImageRetentionCallback,
+ LoggingCallback,
+ OperatorNormalizerCallback,
+ OtelCallback,
+ OtelErrorCallback,
+ PromptInstructionsCallback,
+ TelemetryCallback,
+ TrajectorySaverCallback,
+)
+
+__all__ = [
+ "AsyncCallbackHandler",
+ "ImageRetentionCallback",
+ "LoggingCallback",
+ "TrajectorySaverCallback",
+ "BudgetManagerCallback",
+ "TelemetryCallback",
+ "OtelCallback",
+ "OtelErrorCallback",
+ "OperatorNormalizerCallback",
+ "PromptInstructionsCallback",
+]
diff --git a/libs/python/cua/cua/runtime.py b/libs/python/cua/cua/runtime.py
new file mode 100644
index 0000000000..7b21a6c1a8
--- /dev/null
+++ b/libs/python/cua/cua/runtime.py
@@ -0,0 +1,34 @@
+"""cua.runtime — sandbox runtime backends.
+
+Usage::
+
+ from cua.runtime import QEMURuntime, TartRuntime
+"""
+
+from cua_sandbox.runtime import (
+ AndroidEmulatorRuntime,
+ DockerRuntime,
+ HyperVRuntime,
+ LumeRuntime,
+ QEMUBaremetalRuntime,
+ QEMUDockerRuntime,
+ QEMURuntime,
+ QEMUWSL2Runtime,
+ Runtime,
+ RuntimeInfo,
+ TartRuntime,
+)
+
+__all__ = [
+ "Runtime",
+ "RuntimeInfo",
+ "DockerRuntime",
+ "QEMURuntime",
+ "QEMUDockerRuntime",
+ "QEMUBaremetalRuntime",
+ "QEMUWSL2Runtime",
+ "LumeRuntime",
+ "HyperVRuntime",
+ "AndroidEmulatorRuntime",
+ "TartRuntime",
+]
diff --git a/libs/python/cua/cua/tools.py b/libs/python/cua/cua/tools.py
new file mode 100644
index 0000000000..bf4b4b22ad
--- /dev/null
+++ b/libs/python/cua/cua/tools.py
@@ -0,0 +1,29 @@
+"""cua.tools — agent tool classes and registry.
+
+Usage::
+
+ from cua.tools import BrowserTool, BaseTool, register_tool
+"""
+
+from agent.tools import (
+ TOOL_REGISTRY,
+ BaseComputerTool,
+ BaseTool,
+ BrowserTool,
+ get_registered_tools,
+ get_tool,
+ register_tool,
+)
+from agent.types import IllegalArgumentError, ToolError
+
+__all__ = [
+ "BaseTool",
+ "BaseComputerTool",
+ "register_tool",
+ "get_registered_tools",
+ "get_tool",
+ "TOOL_REGISTRY",
+ "BrowserTool",
+ "ToolError",
+ "IllegalArgumentError",
+]