Launch HN: Cua (YC X25) – Open-Source Docker Container for Computer-Use Agents
Launch HN: Cua (YC X25) – 用于计算机使用代理的开源 Docker 容器
c/ua 是用于计算机使用 AI 代理的 Docker 容器。
c/ua 是 Computer-Use AI Agents 的 Docker 容器。
导航菜单
切换导航 登录
- 产品
- 解决方案 按公司规模
- 资源 主题
- 开源
- 企业
- 定价
搜索或跳转到...
搜索代码、仓库、用户、问题、拉取请求...
搜索 清除 搜索语法提示
提供反馈
我们会阅读每一条反馈,并非常认真地对待您的意见。 包括我的电子邮件地址以便我可以被联系 取消 提交反馈
已保存的搜索
使用已保存的搜索更快地过滤结果
名称 查询 要查看所有可用的限定符,请参阅我们的文档。 取消 创建已保存的搜索 登录 注册 重置焦点 您在另一个标签页或窗口中登录。 重新加载以刷新您的会话。 您在另一个标签页或窗口中注销。 重新加载以刷新您的会话。 您在另一个标签页或窗口中切换了帐户。 重新加载以刷新您的会话。 忽略警报 {{ message }} trycua / **cua ** 公开
c/ua 是用于 Computer-Use AI Agents 的 Docker 容器。 trycua.com
许可证
MIT license 4.4k stars 164 forks Branches Tags Activity Star 通知 您必须登录才能更改通知设置
附加导航选项
trycua/cua
文件夹和文件
名称| 名称| 上次提交消息| 上次提交日期 ---|---|---|---
最新提交
历史
308 Commits .github/workflows| .github/workflows .vscode| .vscode docs| docs examples| examples img| img libs| libs notebooks| notebooks scripts| scripts .all-contributorsrc| .all-contributorsrc .cursorignore| .cursorignore .dockerignore| .dockerignore .gitignore| .gitignore CONTRIBUTING.md| CONTRIBUTING.md Dockerfile| Dockerfile LICENSE.md| LICENSE.md README.md| README.md pyproject.toml| pyproject.toml pyrightconfig.json| pyrightconfig.json 查看所有文件
仓库文件导航
TL;DR : c/ua(发音为 "koo-ah",是 Computer-Use Agent 的缩写)是一个框架,它使 AI 代理能够在高性能、轻量级的虚拟容器中控制完整的操作系统。 它在 Apple Silicon 上提供高达 97% 的原生速度,并且可以与任何视觉语言模型一起使用。
什么是 c/ua?
- 高性能虚拟化 - 使用 Lume CLI 和
Apple's Virtualization.Framework
,在 Apple Silicon 上创建并运行 macOS/Linux 虚拟机,并具有接近原生的性能(高达原生速度的 97%)。 - 计算机使用界面 & 代理 - 一个框架,允许 AI 系统观察和控制这些虚拟环境 - 与应用程序交互、浏览网络、编写代码和执行复杂的工作流程。
为什么使用 c/ua?
- 安全和隔离:在完全隔离的虚拟环境中运行 AI 代理,而不是授予它们访问您主系统的权限
- 性能:在 Apple Silicon 上接近原生性能
- 灵活性:使用同一框架运行 macOS 或 Linux 环境
- 可重现性:为 AI 代理工作流程创建一致的、确定性的环境
- LLM 集成:内置支持连接到各种 LLM 提供商
系统要求
- 带有 Apple Silicon 的 Mac(M1/M2/M3/M4 系列)
- macOS 15 (Sequoia) 或更高版本
- Python 3.10+(Computer、Agent 和 MCP 库需要)。 我们建议使用 Conda(或 Anaconda)创建一个临时的 Python 环境。
- 用于 VM 镜像的磁盘空间(建议 30GB+)
快速开始
选项 1:仅 Lume CLI(VM 管理)
sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
有关 Lume 的使用说明,请参阅 Lume 文档。
选项 2:完整的计算机使用代理功能
- 安装 Lume CLI:
sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
- 拉取最新的 macOS CUA 镜像:
lume pull macos-sequoia-cua:latest
- 启动 Lume 后台服务:
lume serve
- 安装 Python 库:
pip install cua-computer cua-agent[all]
- 在您的 Python 代码中使用这些库:
from computer import Computer
from agent import ComputerAgent, LLM, AgentLoop, LLMProvider
async with Computer(verbosity=logging.DEBUG) as macos_computer:
agent = ComputerAgent(
computer=macos_computer,
loop=AgentLoop.OPENAI, # or AgentLoop.ANTHROPIC, or AgentLoop.OMNI
model=LLM(provider=LLMProvider.OPENAI) # or LLM(provider=LLMProvider.ANTHROPIC)
)
tasks = [
"Look for a repository named trycua/cua on GitHub.",
]
for task in tasks:
async for result in agent.run(task):
print(result)
浏览 Agent Notebook 以获取一个可直接运行的示例。 6. (可选)您可以将 Agent 与 Gradio UI 一起使用:
from utils import load_dotenv_files
load_dotenv_files()
from agent.ui.gradio.app import create_gradio_ui
app = create_gradio_ui()
app.launch(share=False)
选项 3:从源代码构建 (Nightly)
如果您想为该项目做出贡献或需要最新的 nightly 功能:
# 克隆仓库
git clone https://github.com/trycua/cua.git
cd cua
# 在 VSCode 中打开项目
code ./vscode/py.code-workspace
# 构建项目
./scripts/build.sh
请参阅我们的 Developer-Guide 以获取更多信息。
Monorepo 库
库 | 描述 | 安装 | 版本
---|---|---|---
Lume | CLI,用于使用 Apple 的 Virtualization.Framework
运行具有接近原生性能的 macOS/Linux VM。 | |
Computer | 用于与 macOS/Linux 沙箱交互的计算机使用界面 (CUI) 框架 |
pip install cua-computer
|
Agent | 用于在 macOS/Linux 专用沙箱中运行代理工作流程的计算机使用代理 (CUA) 框架 |
pip install cua-agent
|
文档
为了获得此 monorepo 中软件包的最佳入门体验,我们建议从 Computer 文档开始,以了解 Computer 沙箱的核心功能,然后浏览 Agent 文档以了解 Cua 的 AI 代理功能,最后完成 Notebook 示例。
演示
计算机使用代理的实际演示。 在 Cua 的 Discord 社区 中分享您最令人印象深刻的演示! MCP Server: Work with Claude Desktop and Tableau mcp-claude-tableau.mp4 AI-Gradio: multi-app workflow requiring browser, VS Code and terminal access ai-gradio-clone.mp4 Notebook: Fix GitHub issue in Cursor notebook-github-cursor.mp4
配套库
库 | 描述 | 安装 | 版本
---|---|---|---
Core | Cua 其他软件包使用的核心功能和实用程序 | pip install cua-core
|
PyLume | Lume 的 Python 绑定 |
pip install pylume
| [![PyPI](https://camo.githubusercontent.com/dc81f8cd99d66b602c71a01fa76382a22ca11ab56e576a8e3f46543306d1fea3/68747470733a2f2f696d672e7