aiocua

A Simple Python CUA (Computer Use Agent) Solution

Status

This project is in Technical Preview.

• APIs are subject to change.
• Not ready for production use.

Supported Platforms

• Windows
• macOS

Installation

pip install aiocua

Quick Start

import asyncio
from aiocua import CuaOperator

async def main():
    operator = CuaOperator()

    # Get screen dimensions
    width, height = await operator.dimensions()

    # Take a screenshot (returns base64-encoded string)
    screenshot_base64 = await operator.screenshot()

    # Get monitor info
    monitors = await operator.monitors()
    for m in monitors:
        print(f"Monitor {m.id}: {m.width}x{m.height} (scale={m.scale}, primary={m.primary})")

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

API Reference

All methods on CuaOperator are async.

Mouse

Keyboard

Screen

Other

Testing

pip install aiocua[test]
pytest