Shows my svg

Python macOS Discord PyPI

cua-agent is a general Computer-Use framework with liteLLM integration for running agentic workflows on macOS, Windows, and Linux sandboxes. It provides a unified interface for computer-use agents across multiple LLM providers with advanced callback system for extensibility.

Features

  • Safe Computer-Use/Tool-Use: Using Computer SDK for sandboxed desktops
  • Multi-Agent Support: Anthropic Claude, OpenAI computer-use-preview, UI-TARS, Omniparser + any LLM
  • Multi-API Support: Take advantage of liteLLM supporting 100+ LLMs / model APIs, including local models (huggingface-local/, ollama_chat/, mlx/)
  • Cross-Platform: Works on Windows, macOS, and Linux with cloud and local computer instances
  • Extensible Callbacks: Built-in support for image retention, cache control, PII anonymization, budget limits, and trajectory tracking

Install

pip install "cua-agent[all]"

Quick Start

import asyncio
import os
from agent import ComputerAgent
from computer import Computer

async def main():
    # Set up computer instance
    async with Computer(
        os_type="linux",
        provider_type="cloud",
        name=os.getenv("CUA_CONTAINER_NAME"),
        api_key=os.getenv("CUA_API_KEY")
    ) as computer:
        
        # Create agent
        agent = ComputerAgent(
            model="anthropic/claude-3-5-sonnet-20241022",
            tools=[computer],
            only_n_most_recent_images=3,
            trajectory_dir="trajectories",
            max_trajectory_budget=5.0  # $5 budget limit
        )
        
        # Run agent
        messages = [{"role": "user", "content": "Take a screenshot and tell me what you see"}]
        
        async for result in agent.run(messages):
            for item in result["output"]:
                if item["type"] == "message":
                    print(item["content"][0]["text"])

if __name__ == "__main__":
    asyncio.run(main())

Docs

License

MIT License - see LICENSE file for details.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for trycua from gravatar.com trycua

Credits

Author: TryCua

Requires

Python >=3.12

Provides Extra

openai anthropic omni uitars uitars-mlx uitars-hf glm45v-hf ui cli hud all

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cua_agent-0.4.31.tar.gz (102.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cua_agent-0.4.31-py3-none-any.whl (127.1 kB view details)

Uploaded Python 3

File details

Details for the file cua_agent-0.4.31.tar.gz.

File metadata

  • Download URL: cua_agent-0.4.31.tar.gz
  • Upload date:
  • Size: 102.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for cua_agent-0.4.31.tar.gz
Algorithm Hash digest
SHA256 001896301c9a6710ac3b62f705b599a31b2d1b56f9fbb08eb3b55a410c5b37ff
MD5 ac4e96ed85dc4b1f3b4cf21f75676b70
BLAKE2b-256 a7344935641295874a7aff5fe47068afe1c0c557cd71632f43de6d868fbd56c6

See more details on using hashes here.

File details

Details for the file cua_agent-0.4.31-py3-none-any.whl.

File metadata

  • Download URL: cua_agent-0.4.31-py3-none-any.whl
  • Upload date:
  • Size: 127.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for cua_agent-0.4.31-py3-none-any.whl
Algorithm Hash digest
SHA256 468059d6257d41811a69bbe7dadc410c61d373239fcb233e703fe00c2c30e92a
MD5 5f20b847b6c6dbce47587b3ac5dec877
BLAKE2b-256 aba8e32b605a1393440a0bceaaf029c7b92e0e5f993d80f09d2880249e0c450e

See more details on using hashes here.

Release history Release notifications | RSS feed

0.8.4

0.8.3

0.8.2

0.8.1

0.7.38

0.7.37

0.7.36

0.7.35

0.7.34

0.7.33

0.7.32

0.7.31

0.7.30

0.7.29

0.7.28

0.7.27

0.7.26

0.7.25

0.7.24

0.7.23

0.7.22

0.7.21

0.7.20

0.7.19

0.7.18

0.7.17

0.7.16

0.7.15

0.7.14

0.7.13

0.7.12

0.7.11

0.7.10

0.7.9

0.7.8

0.7.6

0.7.5

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.2

0.6.1

0.6.0

0.5.2

0.5.1

0.5.0

0.4.53

0.4.52

0.4.50

0.4.48

0.4.47

0.4.46

0.4.45

0.4.39

0.4.38

0.4.37

0.4.36

0.4.35

0.4.34

0.4.33

0.4.32

This release

0.4.31

0.4.30

0.4.29

0.4.28

0.4.27

0.4.26

0.4.25

0.4.24

0.4.23

0.4.22

0.4.21

0.4.20

0.4.19

0.4.18

0.4.17

0.4.16

0.4.15

0.4.14

0.4.13

0.4.12

0.4.11

0.4.10

0.4.9

0.4.8

0.4.7

0.4.6

0.4.5

0.4.4

0.4.3

0.4.2

0.4.1

0.4.0

0.4.0b4 pre-release

0.4.0b3 pre-release

0.4.0b2 pre-release

0.4.0b1 pre-release

0.3.2

0.3.1

0.2.15

0.2.14

0.2.13

0.2.12

0.2.11

0.2.10

0.2.9

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.44

0.1.43

0.1.42

0.1.41

0.1.40

0.1.39

0.1.38

0.1.37

0.1.35

0.1.34

0.1.33

0.1.32

0.1.31

0.1.30

0.1.29

0.1.28

0.1.27

0.1.26

0.1.25

0.1.24

0.1.23

0.1.22

0.1.21

0.1.20

0.1.19

0.1.18

0.1.17

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page