Cua
Create and run high-performance macOS and Linux VMs on Apple Silicon, with built-in support for AI agents.
Libraries
| Library | Description | Installation | Version |
|---|---|---|---|
| Lume | CLI for running macOS/Linux VMs with near-native performance using Apple's Virtualization.Framework. |
brew install lume |
 |
| Computer | Computer-Use Interface (CUI) framework for interacting with macOS/Linux sandboxes | pip install cua-computer |
 |
| Agent | Computer-Use Agent (CUA) framework for running agentic workflows in macOS/Linux dedicated sandboxes | pip install cua-agent |
 |
Lume
Originally looking for Lume? If you're here for the original Lume project, it's now part of this monorepo. Simply install with brew and refer to its documentation.
Docs
For optimal onboarding, we recommend starting with the Computer documentation to cover the core functionality of the Computer sandbox, then exploring the Agent documentation to understand Cua's AI agent capabilities, and finally working through the Notebook examples to try out the Computer-Use interface and agent.
Demos
Demos of the Computer-Use Agent in action. Share your most impressive demos in Cua's Discord community!
AI-Gradio: multi-app workflow requiring browser, VS Code and terminal access
Notebook: Fix GitHub issue in Cursor
Accessory Libraries
| Library | Description | Installation | Version |
|---|---|---|---|
| Core | Core functionality and utilities used by other Cua packages | pip install cua-core |
 |
| PyLume | Python bindings for Lume | pip install pylume |
 |
| Computer Server | Server component for the Computer-Use Interface (CUI) framework | pip install cua-computer-server |
 |
| SOM | Self-of-Mark library for Agent | pip install cua-som |
 |
Contributing
We welcome and greatly appreciate contributions to Cua! Whether you're improving documentation, adding new features, fixing bugs, or adding new VM images, your efforts help make lume better for everyone. For detailed instructions on how to contribute, please refer to our Contributing Guidelines.
Join our Discord community to discuss ideas or get assistance.
License
Cua is open-sourced under the MIT License - see the LICENSE file for details.
Trademarks
Apple, macOS, and Apple Silicon are trademarks of Apple Inc. Ubuntu and Canonical are registered trademarks of Canonical Ltd. This project is not affiliated with, endorsed by, or sponsored by Apple Inc. or Canonical Ltd.
Stargazers over time
Contributors
 f-trycua 💻 |
 Pedro Piñera Buendía 💻 |