diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.json index 9aea034a..bee0e1c8 100644 --- a/docs/content/docs/meta.json +++ b/docs/content/docs/meta.json @@ -5,9 +5,8 @@ "defaultOpen": true, "pages": [ "index", - "quickstart-ui", - "quickstart-cli", "quickstart-devs", + "quickstart-cli", "telemetry", "---[BookCopy]Computer Playbook---", "...computer-sdk", diff --git a/docs/content/docs/quickstart-ui.mdx b/docs/content/docs/quickstart-ui.mdx deleted file mode 100644 index 72bac935..00000000 --- a/docs/content/docs/quickstart-ui.mdx +++ /dev/null @@ -1,216 +0,0 @@ ---- -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. - - - - -## 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. - - - - - -## Set Up Your Computer Environment - -Choose how you want to run your cua computer. **Cloud containers are recommended** for the easiest setup: - - - - - **Easiest & safest way to get started** - - 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 - - Your cloud container will be automatically configured and ready to use. - - - - - 1. Install lume cli - - ```bash - /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)" - ``` - - 2. Start a local cua container - - ```bash - lume run macos-sequoia-cua:latest - ``` - - - - - 1. Enable Windows Sandbox (requires Windows 10 Pro/Enterprise or Windows 11) - 2. Install pywinsandbox dependency - - ```bash - pip install -U git+git://github.com/karkason/pywinsandbox.git - ``` - - 3. Windows Sandbox will be automatically configured when you run the CLI - - - - - 1. Install Docker Desktop or Docker Engine - - 2. Pull the CUA Ubuntu container - - ```bash - docker pull --platform=linux/amd64 trycua/cua-ubuntu:latest - ``` - - - - - - - - -## Install and Run cua - - - - - -### Install uv - - - - -```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 -``` - - - - -```powershell -# Use irm to download the script and execute it with iex: -powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -``` - - - - -### Install Python 3.12 - -```bash -uv python install 3.12 -``` - -### Run cua - -```bash -uv run --with "cua-agent[ui]" -m agent.ui -``` - - - - - -### Install conda - - - - -```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 -``` - - - - -```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 -``` - - - - -```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 -``` - - - - -### 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 -``` - - - - - -### Install cua - -```bash -pip install "cua-agent[ui]" cua-computer -``` - -### Run the Agent UI - -```bash -python -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" - - - - ---- - -For advanced Python usage, see the [Quickstart for Developers](/quickstart-devs).