---
id: cua-agent
version: "0.8.4"
license: unclear
license_treatment: unclear
maintenance: active
---

# cua-agent — Cua (Computer Use) Agent for AI-driven computer interaction

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

## What it is and what it does

Cua Agent is a framework for building AI-driven agents that can interact with computers—running commands, manipulating interfaces, and automating workflows across macOS, Windows, and Linux. It integrates with liteLLM to support multiple AI model providers, allowing developers to define agentic workflows that execute in sandboxed environments. The package handles the complexity of cross-platform computer interaction, providing a structured API for agents to perceive and act on desktop systems.

The framework is designed for scenarios where an AI model needs to autonomously perform tasks on a computer—from testing and quality assurance to data extraction and system administration. It abstracts away platform-specific details while maintaining security through sandboxing, and its integration with liteLLM means you can swap between different AI providers without rewriting agent logic.

Use it for:

- Automate repetitive desktop tasks like form filling, data entry, or file management across platforms
- Build AI-powered testing agents that interact with web applications and desktop software
- Create autonomous workflows for system administration, monitoring, and configuration tasks
- Develop agents that extract information from visual interfaces and unstructured desktop data
- Prototype and test agentic AI behaviors in controlled sandbox environments before deployment

## Worth the install?

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

Cua Agent provides a framework for building agentic workflows that interact with computers through AI models, supporting macOS, Windows, and Linux sandboxes with liteLLM integration.

Yes, if you need to build AI agents that interact with computers across multiple platforms. The low install friction, active maintenance, and integration with liteLLM make it accessible. However, verify the license terms before use—the unclear license treatment is a blocker for some contexts. No known vulnerabilities and solid dependency choices support adoption.

## Install

pip install cua-agent
uv add cua-agent
poetry add cua-agent

## Installing cua-agent

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance status with a recent release cycle (51 days since last update). Twelve runtime dependencies including established libraries like httpx, aiohttp, pydantic, and litellm suggest a mature dependency ecosystem.

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 use in proprietary or restricted contexts.

Quickstart:

pip install cua-agent

from cua_agent import Agent

agent = Agent()
# Configure with liteLLM model and run agentic workflow

Requires Python 3.11 or later (supports current versions up to <3.14). Depends on cua-core and litellm for core functionality.

Verify before relying:

- Specific sandbox isolation guarantees and security model for computer interaction workflows
- Performance characteristics and latency for real-time agent operations across platforms
- Exact license terms and any commercial use restrictions

## Package facts

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

## Tags

ai agent computer interaction, agentic workflow framework, computer use automation, litellm agent sdk, ai-driven desktop automation, sandbox-based agent framework, multiplatform ai agent, agent-framework, computer-automation, litellm-integration

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