Cua：给 AI Agent 一台可操作的电脑

项目简介

Cua（Computer-Use Agents）是一个面向 computer-use 的开源工具集，核心理念是「给 AI agent 一台能真正使用的电脑」。仓库同时包含多个组件：Cua Spaces（为 agent 提供完整桌面的桌面应用）、Cua Driver（桌面自动化驱动）、Lume（本地虚拟机）、Cua SDK 与 cua CLI、CUA-S1 小模型，以及 Cua Bench 评测工具。

你可以自带 agent 和模型，Cua 负责提供计算机与自动化能力。

主要功能

Cua Spaces

一款桌面应用，把完整的桌面交给 agent。每个桌面是一个 Space：可以在 Mac 上本地构建的 macOS 虚拟机，也可以是 Linux 或 Omarchy 镜像；Space 可以运行在你的 Mac、你拥有的其他机器，或你自己的云账号（AWS、Google Cloud、Modal）中，应用会把它们收纳在菜单栏与刘海里。

• Teleport：把已登录的应用（如 Chrome、Slack）移入 Space，打开时仍保持登录。会话保存在 Cua Keyvault 中并在 Mac 上加密，经你批准后才会进入 Space。
• Multiplayer：你和 agent 在同一桌面上协作，各自拥有光标；你可以随时接管做出选择，再把桌面交还。
• Agent-ready images：镜像内置 cua-spacesd，Space 一启动，agent 就能获取进程、文件、截图与输入。

Cua Driver

为 agent 提供检查和操作 macOS、Windows、Linux 上原生桌面应用与浏览器的工具，可通过 CLI、MCP 或类型化 SDK 接入。在应用与平台支持的情况下，后台投递让 agent 工作时不必移动你的指针或抢占焦点。

Lume

基于 Apple 的 Virtualization.Framework，在 Apple Silicon 上创建和管理本地 macOS 与 Linux 虚拟机。

Cua SDK 与 CLI

一套 SDK 和一个 cua 命令，覆盖本地虚拟机与容器，以及任何运行了 cua-spacesd 的机器。同一套 API 提供 Python（pip install cua）、TypeScript（@trycua/cua）和 Rust（cua-sdk）版本，可嵌入进程内或通过共享的 cua daemon 运行；Swift 与 Kotlin 绑定尚未发布。沙箱内不需要额外 agent 层，可由你自己的 harness 驱动。cua host setup 可让本机通过 cua.ai relay 可达，无需端口转发。

cua sb create ubuntu --name dev          # gVisor 容器，首次使用时初始化
cua sb exec dev uname -a
cua sb screenshot dev
cua sb rm dev

Python 中创建同样的沙箱：

from cua_sandbox import Image, Sandbox

async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
    print((await sb.shell.run("uname -a")).stdout)

CUA-S1

面向 computer-use 的小型专用 System 1 模型族，「System 1」是工程类比，指快速、有边界的决策（例如某个字段该填什么值、某个元素是否应当保持不动），并非严格的模型架构分类，也不替代通用 agent 的规划推理。首个研究配置聚焦表单：从结构化界面元素和文档值中打分决策，而不是逐 token 生成回复。项目包含模型代码、合成数据生成、训练与评测；GitHub 上的是早期源码研究发布，模型权重单独托管在 Hugging Face。

Cua Bench

用于创建任务、评测 agent 并导出轨迹的基准工具。

安装与使用

Cua Spaces 需要 macOS 26 或更高版本：

curl -fsSL https://cua.ai/install.sh | sh

在 macOS 上，安装脚本默认选中 Cua Spaces 应用并安装 cua CLI；你也可以下载签名的 .dmg 或 .pkg。命令行工具始终安装，是否加装 Cua Spaces（默认开）与 Cua Driver（默认关）由你选择。

Cua Driver（macOS / Linux）：

/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"

Windows（PowerShell）：

irm https://cua.ai/driver/install.ps1 | iex

Lume：

/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"

各组件都有对应的 quickstart 文档，例如用 Lume 从 Apple 恢复镜像创建一台 macOS Tahoe 虚拟机并通过 SSH 连接，或让 agent 在计算器里算出 6 × 7 并核验结果为 42。

注意事项

• 各组件文档分散：Cua Spaces、Cua Driver、Lume、Cua SDK/CLI、Cua Bench 都有独立的快速上手页面。
• 后台投递不移动指针、不抢焦点的能力受应用与平台支持范围限制。
• Cua Spaces 对个人免费；Pro 为每月 18 美元，Teams 为每席位每月 30 美元、1 席位起。
• 应用以 FSL-1.1-MIT 许可源码可获取，仓库整体为 MIT；CUA-S1 源码为 MIT，权重与数据集的适用范围、限制和许可需查看各自的模型卡与数据集卡。

---

本作品整理自 GitHub 开源项目 trycua/cua，原作者 @trycua，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。