What is Cua?

import asyncio
from cua import Sandbox, Image, ComputerAgent

async def main():
    async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
        agent = ComputerAgent(
            model="cua/anthropic/claude-sonnet-4-5",
            tools=[sb],
        )
        async for result in agent.run([{
            "role": "user",
            "content": "Open Firefox and search for 'open source computer use'",
        }]):
            for item in result["output"]:
                if item["type"] == "message":
                    print(item["content"][0]["text"])

asyncio.run(main())

pip install cua

async with Sandbox.ephemeral(Image.linux()) as sb:   # cloud Linux container
async with Sandbox.ephemeral(Image.macos()) as sb:   # cloud macOS VM
async with Sandbox.ephemeral(Image.windows()) as sb: # cloud Windows VM
async with Sandbox.ephemeral(Image.android()) as sb: # cloud Android VM
async with Sandbox.ephemeral(Image.linux(), local=True) as sb:  # local Docker

await sb.shell.run("npm install")          # run shell commands
await sb.screenshot()                      # capture the screen
await sb.mouse.click(x, y)                # click
await sb.keyboard.type("hello")            # type
await sb.keyboard.press("ctrl+c")         # key combos
await sb.mobile.tap(x, y)                 # Android touch
async with sb.tunnel.forward(3000) as t:  # forward ports
    print(t.url)

agent = ComputerAgent(
    model="cua/anthropic/claude-sonnet-4-5",  # or openai, gemini, qwen, ...
    tools=[sb],
)
async for result in agent.run(messages): ...

img = (
    Image.linux()
    .apt_install("curl", "ffmpeg")
    .pip_install("playwright")
    .env(API_KEY="...")
    .run("playwright install chromium")
)
async with Sandbox.ephemeral(img) as sb: ...