Quickstart (GUI)

Introduction

cua combines Computer (interface) + Agent (AI) for automating desktop apps. The Agent UI provides a simple chat interface to control your remote computer using natural language.

Create Your First cua Container

1. Go to trycua.com/signin
2. Navigate to Dashboard > Containers > Create Instance
3. Create a Medium, Ubuntu 22 container
4. Note your container name and API key

Install and Run cua

# Use curl to download the script and execute it with sh:
curl -LsSf https://astral.sh/uv/install.sh | sh

# If your system doesn't have curl, you can use wget:
# wget -qO- https://astral.sh/uv/install.sh | sh

# Use irm to download the script and execute it with iex:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uv python install 3.12

uv run --with "cua-agent[ui]" -m agent.ui

Start Chatting

Open your browser to the displayed URL and start chatting with your computer-using agent.

You can ask your agent to perform actions like:

• "Open Firefox and go to github.com"
• "Take a screenshot and tell me what's on the screen"
• "Type 'Hello world' into the terminal"