Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/trycua/cua

Open-source infrastructure for Computer-Use Agents. Sandboxes, SDKs, and benchmarks to train and evaluate AI agents that can control full desktops (macOS, Linux, Windows).
https://github.com/trycua/cua

agent ai-agent apple computer-use computer-use-agent containerization cua desktop-automation hacktoberfest lume macos manus operator swift virtualization virtualization-framework windows windows-sandbox

Last synced: 2 days ago
JSON representation

Open-source infrastructure for Computer-Use Agents. Sandboxes, SDKs, and benchmarks to train and evaluate AI agents that can control full desktops (macOS, Linux, Windows).

Awesome Lists containing this project

README 

          


  

    

      

      

      Cua logo

    

  



  
Build, benchmark, and deploy agents that use computers



  


    cua.ai

    Discord

    Twitter

    Documentation

    


trycua%2Fcua | Trendshift

  






**Cua** is an open-source platform for building, benchmarking, and deploying agents that can use any computer, with isolated, self-hostable sandboxes (Docker, QEMU, Apple Vz).





  




## Choose Your Path



  

    

    If you want to...

    Check out

  

  

    

    Build AI agents that interact with any desktop, or run isolated code execution environments for AI coding assistants

    Cua

  

  

    

    Benchmark computer-use models on standardized tasks, or train agents with reinforcement learning

    Cua-Bench

  

  

    

    Run macOS and Linux VMs at near-native speed on Apple Silicon for CI/CD, testing, or agent workloads

    Lume

  



---



## Cua - Agentic UI Automation & Code Execution



Build agents that see screens, click buttons, and complete tasks autonomously. Run isolated code execution environments for AI coding assistants like Claude Code, Codex CLI, or OpenCode.



Cua Architecture



```python

# Requires Python 3.12 or 3.13

from computer import Computer

from agent import ComputerAgent



computer = Computer(os_type="linux", provider_type="cloud")

agent = ComputerAgent(model="anthropic/claude-sonnet-4-5-20250929", computer=computer)



async for result in agent.run([{"role": "user", "content": "Open Firefox and search for Cua"}]):

    print(result)

```



**[Get Started](https://cua.ai/docs/cua/guide/get-started/set-up-sandbox)** | **[Examples](https://cua.ai/docs/cua/examples)** | **[API Reference](https://cua.ai/docs/cua/reference/agent-sdk)**



---



## Cua-Bench - Benchmarks & RL Environments



Evaluate computer-use agents on OSWorld, ScreenSpot, Windows Arena, and custom tasks. Export trajectories for training.



Cua-Bench Architecture



```bash

# Install and create base image

cd cua-bench

uv tool install -e . && cb image create linux-docker



# Run benchmark with agent

cb run dataset datasets/cua-bench-basic --agent cua-agent --max-parallel 4

```



**[Get Started](https://cua.ai/docs/cuabench/guide/getting-started/first-steps)** | **[Registry](https://cuabench.ai/registry)** | **[CLI Reference](https://cua.ai/docs/cuabench/reference/cli-reference)**



---



## Lume - macOS Virtualization



Create and manage macOS/Linux VMs with near-native performance on Apple Silicon using Apple's Virtualization.Framework.



Lume Architecture



```bash

# Install Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"



# Pull & start a macOS VM

lume run macos-sequoia-vanilla:latest

```



**[Get Started](https://cua.ai/docs/lume)** | **[FAQ](https://cua.ai/docs/lume/guide/getting-started/faq)** | **[CLI Reference](https://cua.ai/docs/lume/reference/cli-reference)**



---



## Packages



| Package                                                               | Description                                                |

| --------------------------------------------------------------------- | ---------------------------------------------------------- |

| [cua-agent](https://cua.ai/docs/cua/reference/agent-sdk)              | AI agent framework for computer-use tasks                  |

| [cua-computer](https://cua.ai/docs/cua/reference/computer-sdk)        | SDK for controlling desktop environments                   |

| [cua-computer-server](https://cua.ai/docs/cua/reference/computer-sdk) | Driver for UI interactions and code execution in sandboxes |

| [cua-bench](https://cua.ai/docs/cuabench)                             | Benchmarks and RL environments for computer-use            |

| [lume](https://cua.ai/docs/lume)                                      | macOS/Linux VM management on Apple Silicon                 |

| [lumier](https://cua.ai/docs/lume/guide/advanced/lumier)              | Docker-compatible interface for Lume VMs                   |



## Resources



- [Documentation](https://cua.ai/docs) — Guides, examples, and API reference

- [Blog](https://www.cua.ai/blog) — Tutorials, updates, and research

- [Discord](https://discord.com/invite/mVnXXpdE85) — Community support and discussions

- [GitHub Issues](https://github.com/trycua/cua/issues) — Bug reports and feature requests



## Contributing



We welcome contributions! See our [Contributing Guidelines](CONTRIBUTING.md) for details.



## License



MIT License — see [LICENSE](LICENSE.md) for details.



Third-party components have their own licenses:



- [Kasm](libs/kasm/LICENSE) (MIT)

- [OmniParser](https://github.com/microsoft/OmniParser/blob/master/LICENSE) (CC-BY-4.0)

- Optional `cua-agent[omni]` includes ultralytics (AGPL-3.0)



## Trademarks



Apple, macOS, Ubuntu, Canonical, and Microsoft are trademarks of their respective owners. This project is not affiliated with or endorsed by these companies.



---






[![Stargazers over time](https://starchart.cc/trycua/cua.svg?variant=adaptive)](https://starchart.cc/trycua/cua)



Thank you to all our [GitHub Sponsors](https://github.com/sponsors/trycua)!



coderabbit-cli