trycua cua
给 AI agent 一台可以使用的计算机。Cua 提供开源桌面自动化、隔离云桌面、本地 macOS 虚拟机和用于评估 computer-use agent 的基准测试。立即在 run.cua.ai 体验 Cua Fleets
选择你的路径
- Cua Fleets:配置一台 Linux 桌面,运行一条命令,并保存截图。
- Cua Driver:操作计算器并验证其结果。
- Lume:创建一个 Tahoe 虚拟机并通过 SSH 连接。
- Cua Bench:创建并验证一个模拟任务。
你提供 agent 和模型。Cua 提供计算机和自动化工具。
Computer-Use 2.0 描述的是 agent 在同一任务中在代码、API 和图形界面之间切换。查看 Cua Driver 的实际运行
两个 Cua Driver 会话在 Omarchy 桌面上分别选择 LibreOffice Calc 中的单元格和 Inkscape 中的对象,同时一个终端保持在前台。观看 50 秒演示,然后在 Fleet 上探索 Omarchy。
recording.mp4
Cua Fleets
在 run.cua.ai 配置隔离云桌面。一个 Fleet 维护沙箱容量;你的代码从池中认领一台桌面,并使用 Sandbox SDK 在其中运行命令、捕获截图并与应用交互。
你的第一个结果:配置一台 Linux 桌面,运行 uname -a,保存截图,并删除云资源。本教程涵盖 Fleet 凭据、依赖项和清理。池在认领结束后可以保留付费容量,因此请遵循其清理步骤。
本地沙箱和 Fleets 共享 Sandbox SDK,但凭据、镜像、操作和运行时要求不同。使用运行时支持参考来选择环境。对于你自己的硬件,请参阅管理本地沙箱生命周期。
你的第一个 Cloud Fleet | Fleet 概览 | Sandbox SDK 参考
Cua Driver
为你的 agent 提供在 macOS、Windows 和 Linux 上检查和操作原生桌面应用及浏览器的工具。通过 CLI、MCP 或类型化 SDK 连接。后台交付让 agent 在应用和平台支持的情况下无需移动你的指针或抢占焦点即可工作;有关边界,请参阅平台支持。
macOS / Linux
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
Windows (PowerShell)
irm https://cua.ai/driver/install.ps1 | iex
你的第一个结果:连接你的 agent,让它在计算器中计算 6 × 7,并让它验证应用显示 42。本教程涵盖平台设置、权限和 agent 连接。
驱动你的第一个应用 | 安装 | CLI 参考
使用 Claude Code、Codex、Cursor、OpenClaw 或其他 agent?找到你的集成方式。
源代码文档和架构说明位于 libs/cua-driver/README.md。
Lume
使用 Apple 的 Virtualization.Framework 在 Apple Silicon 上创建和管理本地 macOS 和 Linux 虚拟机。
/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
你的第一个结果:从 Apple 恢复镜像创建一个原生 macOS Tahoe 虚拟机,启动它,并通过 SSH 连接。本教程直接使用 Lume CLI 并解释无人值守设置的默认值。
创建你的第一个 Lume 虚拟机 | 安装 | CLI 参考
Cua Bench
构建 computer-use 任务、评估 agent,并导出轨迹用于训练。从一个不需要 VM、Docker 或模型 API 密钥的模拟任务开始。
安装 Python 3.12 或 3.13 和 uv 后:
uv tool install 'cua-bench[browser]'
uv tool run --from 'cua-bench[browser]' playwright install chromium
你的第一个结果:创建一个小任务,运行其参考解决方案,并验证其评估器报告奖励为 1.0。然后自己尝试同样的任务。
构建你的第一个任务 | 什么是 Cua-Bench? | CLI 参考 | 与我们合作
资源
- 文档 — 指南、示例和 API 参考
- 博客 — 教程、更新和研究
- Discord — 社区支持和讨论
- GitHub Issues — Bug 报告和功能请求
- 安全 — 私密漏洞报告
引用
如果 Cua 支持了你的研究,请引用该软件:
@software{cua2025,
author = {{Cua AI, Inc.}},
title = {Cua},
year = {2025},
url = {https://github.com/trycua/cua},
license = {MIT}
}
为可复现性,请在你的实验中包含所使用的 Cua 版本或提交。引用元数据也可在 CITATION.cff 中获取。
贡献
我们欢迎贡献!详情请参阅我们的贡献指南。
许可证
MIT 许可证 — 详情请参阅 LICENSE。
第三方组件有自己的许可证:
- Kasm (MIT)
- OmniParser (CC-BY-4.0)
- 可选的 cua-agent[omni] 包含 ultralytics (AGPL-3.0)
商标
Apple、macOS、Ubuntu、Canonical 和 Microsoft 是各自所有者的商标。本项目与这些公司无关联,也未获得其认可。
赞助者
感谢我们所有的 GitHub 赞助者!
Adam Cohen Hillel CodeRabbit Zephyr Cloud IO