Computer SDK Changelog

All notable changes to the Computer SDK are documented here.

0.5.x

v0.5.12 (2026-01-26)

Initial release or no path-specific changes found

v0.5.11 (2026-01-24)

Bump cua-computer to v0.5.11 by @github-actions[bot]
Setup UV as venv manager for computer (#789) by @synacktraa

v0.5.10 (2026-01-17)

Maintenance release.

v0.5.7 (2026-01-17)

Bump cua-computer to v0.5.7 by @github-actions[bot]
fix(computer): prevent data loss when tracing.stop path conflicts with trace directory (#814) by @Harsh Verma
Improve Computer API Server connection warnings and timeout errors (#803) by @Fizza Mukhtar
feat(computer): add OpenTelemetry instrumentation (#663) by @r33drichards

v0.5.6 (2026-01-12)

Initial release or no path-specific changes found

v0.5.5 (2026-01-12)

Initial release or no path-specific changes found

v0.5.4 (2026-01-12)

Bump cua-computer to v0.5.3 by @github-actions[bot]
Bump cua-computer to v0.5.2 by @github-actions[bot]
refactor(docs): reorganize lume/cua docs and standardize READMEs (#752) by @Francesco Bonacci
feat(lume,ci): add unattended VM setup and reorganize CI/CD workflows (#729) by @Francesco Bonacci
update dead links due to docs update by @Sarina Li
pyautogui cleanup by @Adam
Revert "refractor docs into 6 sections" by @Adam
refractor docs into 6 sections by @Adam

0.4.x

v0.4.11 (2025-10-29)

Dependencies: pylume: latest

Docs/improve readme by @jamesmurdza in https://github.com/trycua/cua/pull/512
Feature/version bump workflows by @r33drichards in https://github.com/trycua/cua/pull/511
Support display and ephemeral in Docker provider by @ddupont808 in https://github.com/trycua/cua/pull/514
Fix markdown formatting in docs by @jamesmurdza in https://github.com/trycua/cua/pull/523
Jagjeevan's Fix + Merged Main for 4o Model Fix by @sarinali in https://github.com/trycua/cua/pull/522
fix: Added GPT-4o compatibility for screenshot actions with text parameter by @JagjeevanAK in https://github.com/trycua/cua/pull/422
Remove PyLume code and examples by @jamesmurdza in https://github.com/trycua/cua/pull/435
Remove PyLume library by @jamesmurdza in https://github.com/trycua/cua/pull/527
Add test infrastructure with CI/CD #478 by @AceAtDev in https://github.com/trycua/cua/pull/491
Feature/agent loop test by @YeIIcw in https://github.com/trycua/cua/pull/528
Update Agent Loop Test by @YeIIcw in https://github.com/trycua/cua/pull/530
Fix/omniparser predict refactor by @sarinali in https://github.com/trycua/cua/pull/529
Fix agent test condition trigger by @YeIIcw in https://github.com/trycua/cua/pull/531
Fix/agent loop test by @YeIIcw in https://github.com/trycua/cua/pull/532
Add desktop and window management commands to computer interface by @ddupont808 in https://github.com/trycua/cua/pull/516

v0.4.10 (2025-10-14)

Fix XFCE Password Prompts and Lock Screen Issues by @f-trycua in https://github.com/trycua/cua/pull/466
Add Cloud VM Management API by @ddupont808 in https://github.com/trycua/cua/pull/452

v0.4.8 (2025-10-12)

Dependencies: pylume: latest

v0.4.7 (2025-10-03)

Dependencies: pylume: latest

v0.4.6 (2025-09-24)

Dependencies: pylume: latest

🔧 Improve HUD eval script: auto-discover .env and simplify usage by @YeIIcw in https://github.com/trycua/cua/pull/419
Fix Windows Sandbox errors by @ddupont808 in https://github.com/trycua/cua/pull/424

New Contributors

@YeIIcw made their first contribution in https://github.com/trycua/cua/pull/419
@JagjeevanAK made their first contribution in https://github.com/trycua/cua/pull/420

v0.4.5 (2025-09-05)

Dependencies: pylume: latest

Fix x/y scrolling by @ddupont808 in https://github.com/trycua/cua/pull/393
Fix invalid image error with some providers (i.e. WinSandbox)
Reference documentation batch by @onel in https://github.com/trycua/cua/pull/390

v0.4.4 (2025-08-19)

Dependencies: pylume: latest

Update agent/computer SDKs to match changes in telemetry SDK by @jamesmurdza in https://github.com/trycua/cua/pull/355
Bugfixes - Removed slashes from container name by @ddupont808 in https://github.com/trycua/cua/pull/358

v0.4.3 (2025-08-15)

Dependencies: pylume: latest

Fixed bug where the image kwarg would be ignored

v0.4.2 (2025-08-14)

Dependencies: pylume: latest

[Computer] Add Docker as a local VM provider by @ddupont808 in https://github.com/trycua/cua/pull/339

v0.4.1 (2025-08-05)

Dependencies: pylume: latest

v0.4.0 (2025-07-28)

Bumped cua-computer to use latest cua-core

0.3.x

v0.3.7 (2025-07-16)

Dependencies: pylume: latest

v0.3.6 (2025-07-16)

Dependencies: pylume: latest

v0.3.5 (2025-07-10)

Dependencies: pylume: latest

v0.3.4 (2025-07-03)

Dependencies: pylume: latest

v0.3.3 (2025-07-03)

Dependencies: pylume: latest

v0.3.2 (2025-07-03)

Dependencies: pylume: latest

v0.3.1 (2025-07-01)

Dependencies: pylume: latest

v0.3.0 (2025-06-25)

Dependencies: pylume: latest

0.2.x

v0.2.13 (2025-06-24)

Dependencies: pylume: latest

v0.2.12 (2025-06-20)

Dependencies: pylume: latest

v0.2.11 (2025-06-18)

Dependencies: pylume: latest

v0.2.10 (2025-06-10)

Dependencies: pylume: latest

Removed warning when calling start_vm on the CloudProvider
Add disconnect() method for Computer
Fixed file_exists and directory_exists not being implemented in the computer-server
Added keyboard/mouse primitives ( mouse_up, mouse_down, key_up, key_down )
Added file system commands to computer interface
Added file system interface pytests
Improved computer interface accessibility tree output on macOS, now includes menubar and dock items, along with preserving z-ordering
Increased timeout for web socket commands due to a TimeoutError if the accessibility tree takes longer than 30 seconds to crawl

Changes reference:

... old actions haven't changed

Disconnect from computer interface / cleanup websocket resources
await computer.disconnect()

New mouse actions
await computer.interface.mouse_down(x, y, button="left")  # Press and hold a mouse button
await computer.interface.mouse_up(x, y, button="left")    # Release a mouse button

New keyboard actions
await computer.interface.key_down("command")    # Press and hold a key
await computer.interface.key_up("command")      # Release a key

New scrolling actions
await computer.interface.scroll(x, y)           # Scroll the mouse wheel

New file-system commands
Fixed: await computer.interface.file_exists(path)      # Check if file exists
Fixed: await computer.interface.directory_exists(path) # Check if directory exists
await computer.interface.read_text(path)        # Read file content
await computer.interface.write_text(path, content) # Write file content
await computer.interface.read_bytes(path)       # Read file content as bytes
await computer.interface.write_bytes(path, content) # Write file content as bytes
await computer.interface.delete_file(path)      # Delete file
await computer.interface.create_dir(path)       # Create directory
await computer.interface.delete_dir(path)       # Delete directory
await computer.interface.list_dir(path)         # List directory contents