Install Dev Containers extension in VS Code
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
Hit play: Once the container builds, you're ready to develop!

What's Included

The dev container automatically:

✅ Sets up Python 3.11 environment
✅ Installs all system dependencies (build tools, OpenGL, etc.)
✅ Configures Python paths for all packages
✅ Installs Python extensions (Black, Ruff, Pylance)
✅ Forwards port 7860 for the Gradio web UI
✅ Mounts your source code for live editing
✅ Creates the required .env.local file

Running Examples

After the container is built, you can run examples directly:

# Run the agent UI (Gradio web interface)
python examples/agent_ui_examples.py

# Run computer examples
python examples/computer_examples.py

# Run computer UI examples
python examples/computer_ui_examples.py

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:

# Required for Anthropic provider
ANTHROPIC_API_KEY=your_anthropic_key_here

# Required for OpenAI provider
OPENAI_API_KEY=your_openai_key_here

Notes

The container connects to host.docker.internal:7777 for Lume server communication
All Python packages are pre-installed and configured
Source code changes are reflected immediately (no rebuild needed)
The container uses the same Dockerfile as the regular Docker development environment