---
id: cua-computer
version: "0.5.19"
license: unclear
license_treatment: unclear
maintenance: active
---

# cua-computer — Computer-Use Interface (CUI) framework powering Cua

License: unclear · Maintenance: active · Downloads: 112.0K/mo

## What it is and what it does

Cua Computer is a framework for building automation and control systems that interact with local desktop environments on macOS and Linux. It abstracts the complexity of GUI interaction, allowing you to programmatically control applications, capture screen state, and automate user-facing tasks through a unified Python interface.

The package sits in an application framework role, bridging between Python code and the native desktop. It depends on websocket and HTTP libraries (websocket-client, websockets, aiohttp) for communication, image processing (pillow) for screen capture and analysis, and pydantic for data validation. It is actively maintained and has no known security vulnerabilities, though its license status remains unconfirmed in the public metadata.

Use it for:

- Automate repetitive GUI workflows on macOS or Linux without writing platform-specific scripts
- Build testing frameworks that validate application behavior by interacting with the desktop UI
- Create headless agents that control local applications programmatically for integration or data extraction
- Develop sandboxed automation tasks that need to interact with multiple applications in sequence

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Cua Computer provides a framework for programmatic interaction with local macOS and Linux desktop environments, enabling automation and control of GUI applications through a unified interface.

Yes, if you need to automate desktop interaction on macOS or Linux and are comfortable with the unclear license status. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a unified interface to a complex problem. Verify the license terms and system requirements before committing to production use.

## Install

pip install cua-computer
uv add cua-computer
poetry add cua-computer

## Installing cua-computer

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance status as of 57 days since latest release. Seven runtime dependencies including pillow, websocket-client, websockets, aiohttp, cua-core, pydantic, and mslex introduce moderate dependency weight.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or restricted-license contexts.

Quickstart:

pip install cua-computer

from cua_computer import Computer
computer = Computer()
# Use computer object to interact with desktop environment

Requires Python >=3.12,<3.14. Designed for local macOS or Linux environments; Windows support status unclear.

Verify before relying:

- Whether the package requires specific system permissions or sandboxing setup on macOS or Linux beyond standard Python installation
- Performance characteristics and latency when controlling GUI elements across network or local connections
- Whether cua-core is a first-party dependency and what its maintenance and licensing status are

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 112.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

desktop automation framework, GUI interaction library, macOS Linux computer control, desktop sandbox interface, automated system interaction, desktop-automation, gui-control, sandbox-framework

[View on SkillFed](https://skillfed.io/packages/cua-computer) · [View on PyPI](https://pypi.org/project/cua-computer/)