From 594e741ae96447dfdfbfac149307fc55325873aa Mon Sep 17 00:00:00 2001
From: Dillon DuPont <ddupont@mit.edu>
Date: Wed, 11 Jun 2025 23:03:00 -0400
Subject: [PATCH] Updated readme with dev container

---
 README.md | 56 +++++++++++++++++++++++++------------------------------
 1 file changed, 25 insertions(+), 31 deletions(-)

diff --git a/README.md b/README.md
index 14652769..763e14b4 100644
--- a/README.md
+++ b/README.md
@@ -54,49 +54,43 @@
 
 
 ### Option 1: Fully-managed install (recommended)
-*I want to be totally guided in the process*
+*Guided install for quick use*
 
 **macOS/Linux/Windows (via WSL):**
 ```bash
 # Requires Python 3.11+
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/scripts/playground.sh)"
 ```
+This script will guide you through setup and launch the Computer-Use Agent UI.
 
-This script will:
-- Ask if you want to use local VMs or C/ua Cloud Containers
-- Install necessary dependencies (Lume CLI for local VMs)
-- Download VM images if needed
-- Install Python packages
-- Launch the Computer-Use Agent UI
+---
 
-### Option 2: Key manual steps
-<details>
-<summary>If you are skeptical running one-install scripts</summary>
+### Option 2: [Dev Container](./.devcontainer/README.md)
+*Best for contributors and development*
 
-**For C/ua Agent UI (any system, cloud VMs only):**
+This repository includes a [Dev Container](./.devcontainer/README.md) configuration that simplifies setup to a few steps:
+
+1. **Install Dev Containers extension** in VS Code
+2. **Clone and open in container:**
+   - Press `Ctrl+Shift+P` (or `Cmd+Shift+P` on Mac)
+   - Type `Dev Containers: Clone Repository in Container Volume...`
+   - Paste the repository URL: `https://github.com/trycua/cua.git`
+   - Open the `.vscode/py.code-workspace` workspace
+3. **Run the Agent UI example:** Once the container builds, you're ready to run the Agent UI example!
+
+
+The Gradio UI will be available at `http://localhost:7860` and will automatically forward to your host machine.
+
+**Environment Variables:**
+You'll need to add your API keys to `.env.local`:
 ```bash
-# Requires Python 3.11+ and C/ua API key
-pip install -U "cua-computer[all]" "cua-agent[all]"
-python -m agent.ui.gradio.app
+# Required for Anthropic provider
+ANTHROPIC_API_KEY=your_anthropic_key_here
+
+# Required for OpenAI provider
+OPENAI_API_KEY=your_openai_key_here
 ```
 
-**For Local macOS/Linux VMs (Apple Silicon only):**
-```bash
-# 1. Install Lume CLI
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
-
-# 2. Pull macOS image
-lume pull macos-sequoia-cua:latest
-
-# 3. Start VM
-lume run macos-sequoia-cua:latest
-
-# 4. Install packages and launch UI
-pip install -U "cua-computer[all]" "cua-agent[all]"
-python -m agent.ui.gradio.app
-```
-</details>
-
 ---
 
 *How it works: Computer module provides secure desktops (Lume CLI locally, [C/ua Cloud Containers](https://trycua.com) remotely), Agent module provides local/API agents with OpenAI AgentResponse format and [trajectory tracing](https://trycua.com/trajectory-viewer).*