mirror of
https://github.com/trycua/computer.git
synced 2026-02-12 16:48:46 -06:00
167 lines
3.3 KiB
Plaintext
167 lines
3.3 KiB
Plaintext
---
|
|
title: Quickstart (GUI)
|
|
description: Get started with the cua Agent UI in 3 steps
|
|
icon: Rocket
|
|
---
|
|
|
|
import { Step, Steps } from 'fumadocs-ui/components/steps';
|
|
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
|
|
import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
|
|
|
|
Get up and running with the cua Agent UI in 3 simple steps.
|
|
|
|
<Steps>
|
|
<Step>
|
|
|
|
## 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.
|
|
|
|
</Step>
|
|
|
|
<Step>
|
|
|
|
## Create Your First cua Container
|
|
|
|
1. Go to [trycua.com/signin](https://www.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
|
|
|
|
</Step>
|
|
|
|
<Step>
|
|
|
|
## Install and Run cua
|
|
|
|
<Accordions type="single" defaultValue="uv">
|
|
|
|
<Accordion title="uv (Recommended)" value="uv">
|
|
|
|
### Install uv
|
|
|
|
<Tabs items={['macOS / Linux', 'Windows']} persist>
|
|
<Tab value="macOS / Linux">
|
|
|
|
```bash
|
|
# 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
|
|
```
|
|
|
|
</Tab>
|
|
<Tab value="Windows">
|
|
|
|
```powershell
|
|
# Use irm to download the script and execute it with iex:
|
|
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
|
|
```
|
|
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
### Install Python 3.12
|
|
|
|
```bash
|
|
uv python install 3.12
|
|
```
|
|
|
|
### Run cua
|
|
|
|
```bash
|
|
uv run --with "cua-agent[ui]" -m agent.ui
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="conda" value="conda">
|
|
|
|
### Install conda
|
|
|
|
<Tabs items={['macOS', 'Linux', 'Windows']} persist>
|
|
<Tab value="macOS">
|
|
|
|
```bash
|
|
mkdir -p ~/miniconda3
|
|
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh -o ~/miniconda3/miniconda.sh
|
|
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
|
|
rm ~/miniconda3/miniconda.sh
|
|
source ~/miniconda3/bin/activate
|
|
```
|
|
|
|
</Tab>
|
|
<Tab value="Linux">
|
|
|
|
```bash
|
|
mkdir -p ~/miniconda3
|
|
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
|
|
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
|
|
rm ~/miniconda3/miniconda.sh
|
|
source ~/miniconda3/bin/activate
|
|
```
|
|
|
|
</Tab>
|
|
<Tab value="Windows">
|
|
|
|
```powershell
|
|
wget "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -outfile ".\miniconda.exe"
|
|
Start-Process -FilePath ".\miniconda.exe" -ArgumentList "/S" -Wait
|
|
del .\miniconda.exe
|
|
```
|
|
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
### Create and activate Python 3.12 environment
|
|
|
|
```bash
|
|
conda create -n cua python=3.12
|
|
conda activate cua
|
|
```
|
|
|
|
### Install and run cua
|
|
|
|
```bash
|
|
pip install "cua-agent[ui]" cua-computer
|
|
python -m agent.ui
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="pip" value="pip">
|
|
|
|
### Install cua
|
|
|
|
```bash
|
|
pip install "cua-agent[ui]" cua-computer
|
|
```
|
|
|
|
### Run the Agent UI
|
|
|
|
```bash
|
|
python -m agent.ui
|
|
```
|
|
|
|
</Accordion>
|
|
|
|
</Accordions>
|
|
|
|
### 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"
|
|
|
|
</Step>
|
|
</Steps>
|
|
|
|
---
|
|
|
|
For advanced Python usage, see the [Quickstart for Developers](/quickstart-devs).
|