본문으로 건너뛰기
오픈소스 전체 목록

Cua

  • 추천0
  • GitHub 별33K
  • 개발라이선스MIT

에이전트에게 컴퓨터를 주는 오픈소스. 앱 조작 Driver · 로컬 VM Lume · 샌드박스 SDK · 평가 Bench (macOS · Windows · Linux)

원본:trycua/cua

요약

에이전트에게 컴퓨터를 주는 오픈소스. 앱 조작 Driver · 로컬 VM Lume · 샌드박스 SDK · 평가 Bench (macOS · Windows · Linux)

설명

Cua 로고

기존에 갖고 있는 컴퓨터들을 하나의 슈퍼컴퓨터로 묶으세요. Cua Spaces는 팀과 에이전트가 함께 쓰는 여러분의 컴퓨터입니다. 이 저장소에는 데스크톱 자동화용 Cua Driver, 로컬 VM용 Lume, CUA-S1 의사결정 모델, 컴퓨터 사용 에이전트를 평가하는 Cua Bench도 들어 있습니다.

Cua Spaces 받기

cua.ai Discord Twitter 문서

trycua/cua | Star History 트렌딩

시작 경로 고르기

에이전트와 모델은 직접 가져와 쓰거나, 특화된 의사결정에는 CUA-S1을 써 보세요. Cua는 컴퓨터와 자동화 도구를 제공합니다. Computer-Use 2.0은 에이전트가 한 작업 안에서 코드, API, 그래픽 인터페이스를 오가는 방식을 설명합니다.


Cua Spaces

기존에 갖고 있는 컴퓨터들을 하나의 슈퍼컴퓨터로 묶으세요. 팀과 에이전트가 함께 쓰는 여러분의 컴퓨터입니다.

Cua Spaces는 에이전트에게 전체 데스크톱을 주는 데스크톱 앱입니다. 각 데스크톱이 하나의 Space이며, Mac에서 로컬로 만든 macOS VM이거나 Linux · Omarchy 이미지입니다. Space는 내 Mac, 내가 가진 다른 컴퓨터, 내 클라우드 계정(AWS, Google Cloud, Modal)에서 돌고, 앱은 이를 메뉴 막대와 노치에 모아 둡니다.

  • 텔레포트. Chrome이나 Slack처럼 로그인된 앱을 Space로 옮기면 로그인된 채로 그곳에서 열립니다. 세션은 Mac에 암호화되어 저장되는 Cua Keyvault에 있고, 내가 승인한 뒤에만 Space로 전달됩니다.
  • 멀티플레이어. 나와 에이전트가 같은 데스크톱에서 각자의 커서로 일합니다. 선택이 필요할 때 끼어들었다가 다시 데스크톱을 넘겨 주세요.
  • 에이전트용 이미지. Spaces 이미지에는 cua-spacesd가 들어 있어, Space가 시작되면 곧바로 에이전트가 프로세스, 파일, 스크린샷, 입력을 쓸 수 있습니다.

https://github.com/user-attachments/assets/a2ccc86b-10d0-48c0-bee6-7ae652ba1c59

macOS 26 이상에서 설치

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

macOS에서는 설치 스크립트가 Cua Spaces 앱을 기본으로 고르고 cua CLI를 함께 추가합니다. 서명된 .dmg를 받거나 Cua Spaces 0.9.4 릴리스에서 .pkg를 받을 수도 있습니다.

Spaces는 개인에게 무료입니다. Pro는 월 $18, Teams는 좌석당 월 $30이며 1좌석부터 바로 쓸 수 있습니다. 요금을 보세요. 앱은 FSL-1.1-MIT 라이선스의 소스 공개(source-available) 소프트웨어입니다.

빠른 시작 | 앱 텔레포트 | Space 공유 | 남는 Mac에서 Space 호스팅 (릴레이, Tailscale, SSH) | 내 클라우드 | 앱 소스


Cua Driver

에이전트가 macOS · Windows · Linux의 네이티브 데스크톱 앱과 브라우저를 살피고 조작하는 도구를 쥐여 줍니다. CLI, MCP, 타입이 있는 SDK로 연결합니다. 백그라운드 전달을 쓰면 앱과 플랫폼이 지원하는 경우 에이전트가 내 포인터를 옮기거나 포커스를 가져가지 않고 일합니다. 한계는 플랫폼 지원을 보세요.

macOS / Linux

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

Windows (PowerShell)

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

첫 결과: 에이전트를 연결하고, 계산기에서 6 × 7을 계산하게 한 뒤 앱에 42가 표시되는지 확인시켜 보세요. 튜토리얼에서 플랫폼 설정, 권한, 에이전트 연결을 다룹니다.

첫 앱 조작해 보기 | 설치 | CLI 레퍼런스

Claude Code, Codex, Cursor, OpenClaw 같은 에이전트를 쓰시나요? 내 에이전트에 맞는 연결법을 찾아보세요. 소스 문서와 구조 노트는 libs/cua-driver/README.md에 있습니다.

Cua Driver 시연

Omarchy 데스크톱에서 터미널이 앞에 떠 있는 동안, 두 개의 Cua Driver 세션이 LibreOffice Calc의 셀과 Inkscape의 개체를 선택합니다. 50초짜리 시연 영상입니다.

https://github.com/user-attachments/assets/b4e5517c-d2db-4758-b4cf-07131b0753b2


Lume

Apple의 Virtualization.Framework를 이용해 Apple Silicon에서 로컬 macOS · Linux VM을 만들고 관리합니다.

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

첫 결과: Apple 복원 이미지로 순정 macOS Tahoe VM을 만들고, 시작한 뒤 SSH로 접속합니다. 튜토리얼은 Lume CLI를 직접 쓰며 무인 설정의 기본값도 설명합니다.

첫 Lume VM 만들기 | 설치 | CLI 레퍼런스


Cua SDK and CLI

로컬 VM과 컨테이너, 그리고 cua-spacesd를 실행하는 모든 컴퓨터를 위한 하나의 SDK와 하나의 cua 명령입니다.

macOS / Linux

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

Windows (PowerShell)

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

터미널에서 스크립트는 먼저 Cua Spaces가 무엇인지 알려 줍니다. 명령줄 도구(cua 프로그램)는 항상 설치되고, Cua Spaces 앱(기본 켜짐)과, 내가 계속 일하는 동안 AI 에이전트가 내 앱을 쓰게 해 주는 Cua Driver(기본 꺼짐)를 더할지는 직접 고릅니다. 그다음 cua auth login을 실행해 로그인하고, AI 코딩 에이전트(Claude Code, Codex, Cursor 등) 설정을 권합니다. 앱은 처음 실행할 때 내 다른 기기가 이 컴퓨터를 써도 되는지 묻습니다. Cua Driver는 sh -s -- --select cua-driver로 추가하고, 선택 단계를 건너뛰려면 --only cua-driver를 씁니다. 설치 옵션을 보세요.

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)
  • SDK: Python(pip install cua), TypeScript(@trycua/cua), Rust(cua-sdk)에서 같은 API를 쓰며, 내 프로세스 안에 내장해 돌리거나 공유 cua daemon을 통해 돌립니다. Swift · Kotlin 바인딩은 아직 나오지 않았습니다.
  • 샌드박스 안에 에이전트가 필요 없습니다. 준비 상태는 런타임과 선택적 포트 확인으로 알 수 있습니다. cua-spacesd(포트 3211)가 들어 있는 이미지는 프로세스, 파일, 스크린샷, cua-driver를 통한 입력, 저지연 영상 · 오디오 스트리밍을 더해 줍니다. SDK에도 에이전트 계층은 없습니다. 샌드박스는 내 하네스에서 구동하세요(가이드).
  • 내가 가진 컴퓨터. cua host setup을 하면 포트 포워딩 없이 cua.ai 릴레이를 통해 이 컴퓨터에 접속할 수 있게 됩니다.

SDK README | 빠른 시작 | CLI 레퍼런스 | 샌드박스 SDK 레퍼런스


CUA-S1

CUA-S1은 컴퓨터 사용을 위한 작고 특화된 System 1 모델 계열입니다. 여기서 「System 1」은 필드에 어떤 값을 넣을지, 어떤 요소를 그대로 둘지 같은 빠르고 범위가 정해진 결정을 가리키는 공학적 비유입니다. 모델 구조의 엄밀한 분류도 아니고, 범용 에이전트의 계획 · 추론을 대체하는 것도 아닙니다.

첫 연구 프로필은 양식(form)에 맞춰져 있습니다. 응답을 토큰 단위로 생성하지 않고, 구조화된 인터페이스 요소와 문서 값으로 결정에 점수를 매깁니다. 동작의 순서는 애플리케이션 코드가 정하고, 선택 사항인 Cua Driver 연동이 명확한 동작 경계 안에서 실행을 맡습니다.

프로젝트에는 Python 모델 코드, 합성 데이터 생성, 학습, 평가가 들어 있습니다. GitHub 구성 요소는 초기 단계의 소스 전용 연구 릴리스이며, 모델 가중치는 Hugging Face에 따로 올라 있습니다. 소스는 MIT 라이선스입니다. 각 모델과 데이터셋 카드에서 범위, 한계, 산출물별 라이선스를 확인하세요.

CUA-S1 둘러보기 | 모델 카드 | 안전 및 배포 안내

Hugging Face의 CUA-S1-FORMS: 모델 가중치 | 데이터셋


Cua Bench

컴퓨터 사용 작업을 만들고, 에이전트를 평가하고, 학습용 궤적을 내보냅니다. 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 레퍼런스 | 함께하기


패키지

패키지설명
cua-drivermacOS · Windows · Linux용 백그라운드 컴퓨터 사용 에이전트
cua SDK와 CLIRust 코어와 cua 명령: 샌드박스, 로컬 런타임, 이미지, Spaces
cua (Python)Python용 cua SDK (pip install cua)
@trycua/cuaNode와 브라우저용 cua SDK, 그리고 @trycua/cua/spaces
Cua (Swift)Swift용 cua SDK (SwiftPM, XCFramework, 아직 출시 전)
cua-sandbox고수준 Python Sandbox/Image/Pool API, cua SDK를 얇게 감싼 것
cua-spacesd샌드박스 안 데몬(포트 3211): 프로세스, 파일, 데스크톱, 스트리밍(gRPC)
Cua Spaces for macOSmacOS용 Spaces 앱: 메뉴 막대와 노치, 라이브 스트림, 텔레포트, 에이전트 스레드
Cua Spaces core공용 Spaces 앱 코어, 그리고 Linux · Windows용 Tauri 앱
cua-bench컴퓨터 사용을 위한 벤치마크와 RL 환경
lumeApple Silicon의 macOS/Linux VM 관리

지원 중단된 패키지

Cua는 더 이상 이 패키지들을 유지보수하지 않습니다. 업데이트와 수정은 없고 CI/CD도 꺼져 있으며, 이미 나온 릴리스와 이미지 태그는 npm, PyPI, Docker Hub에 그대로 남습니다. 지원 중단 패키지에서 옮기기를 보세요.

패키지레지스트리대신 쓸 것
cuabotnpm실행하지 마세요. 알려진 보안 문제가 있습니다. 중지하고 삭제(방법)한 뒤 Cua Driver나 cua CLI를 쓰세요.
cua-computerPyPI샌드박스는 cua SDK, 지금 쓰는 컴퓨터는 Cua Driver
cua-computer-serverPyPIcua-spacesd가 들어 있는 이미지, 또는 Cua Driver
cua-agentPyPICua Driver MCP를 붙인 코딩 에이전트, 또는 cua SDK의 sandbox.agents()
cua-somPyPICua Driver
cua-corePyPICua Driver 또는 cua SDK. cua-bench는 아직 마지막 릴리스를 씁니다
cua-bench-uiPyPI없음. cua-bench만 마지막 릴리스를 쓰고 있습니다
cua-sandbox-appsPyPIcua SDK
@trycua/core, @trycua/playgroundnpm@trycua/cua
lumierDocker HubLume, 또는 cua SDK의 샌드박스
xfce, xfce-cua, kasm, qemu-docker 이미지Docker Hublibs/images의 이미지(ghcr.io/trycua/linux, windows, macos)를 cua SDK로 사용

자료

  • 문서: 가이드, 예제, API 레퍼런스
  • 블로그: 튜토리얼, 소식, 연구
  • Discord: 커뮤니티 지원과 토론
  • GitHub Issues: 버그 신고와 기능 요청
  • 보안: 비공개 취약점 신고

인용

Cua가 연구에 도움이 되었다면 소프트웨어를 인용해 주세요:

@software{cua2025,
  author  = {{Cua AI, Inc.}},
  title   = {Cua},
  year    = {2025},
  url     = {https://github.com/trycua/cua},
  license = {MIT}
}

재현성을 위해 실험에 쓴 Cua 릴리스나 커밋을 함께 적어 주세요. 인용 메타데이터는 CITATION.cff에도 있습니다.

기여하기

기여를 환영합니다. 자세한 내용은 기여 가이드를 보세요.

라이선스

Cua Spaces와 Cua Driver Bench를 뺀 모든 것은 MIT 라이선스입니다(LICENSE). cua SDK와 그 Python · TypeScript · Swift · Kotlin 패키지, cua 명령과 cua daemon, Cua Driver, Lume, 그리고 디렉터리에 따로 적혀 있지 않은 이 저장소의 나머지가 여기에 들어갑니다. Cua Spaces는 FSL-1.1-MIT 라이선스의 소스 공개 소프트웨어입니다. Spaces 앱, cua-spacesd, Cua Keyvault, 텔레포트, Cua Volume(cua-volume), 스트리밍 클라이언트 · 코덱 · 뷰어가 해당합니다. 스트리밍 와이어 프로토콜은 MIT로 남습니다. 사용, 자체 호스팅, 그 위에 만들기는 자유이며 경쟁하는 호스팅 서비스만 안 되고, 각 릴리스는 출시 2년 뒤 MIT가 됩니다. Cua Driver Bench(libs/cua-driver-bench)도 같은 FSL-1.1-MIT를 따르며, 2026년 10월 11일 이전에 공개된 버전(#4973, #4978)은 MIT였습니다. MIT 부분은 FSL 부분에 의존하지 않습니다. 일부 하위 디렉터리는 자체 라이선스를 가지며, LICENSING.md에 각각과 둘이 어떻게 어우러지는지 정리되어 있습니다. Spaces나 Cua Driver Bench를 호스팅 · 관리형 서비스로 제공하시나요? COMMERCIAL.md를 보세요. 이름과 로고 사용은 TRADEMARKS.md를 보세요.

서드파티 구성 요소는 각자의 라이선스를 가집니다:

  • Kasm (MIT)
  • cua-som은 AGPL-3.0-or-later 라이선스의 선택 패키지입니다. 이 패키지가 의존하는 Ultralytics는 자체 라이선스를 유지하므로, 재배포 전에 실제로 설치되는 의존성 버전과 고지문을 확인하세요.
  • Microsoft OmniParser 저장소는 저장소 콘텐츠에 CC-BY-4.0을 명시합니다. 별도의 OmniParser 모델 저장소에서 내려받는 모델 파일은 다른 산출물이므로, 재배포 전에 해당 모델 리비전과 함께 공개된 조건을 확인하세요.
  • 선택 확장인 cua-perception은 MIT인 Cua Driver와 별도로, cua-perception-v<version> GitHub 릴리스의 서명된 자산에서 설치합니다. 각 릴리스는 AGPL-3.0-only OmniParser 모델 산출물, Apache-2.0 PP-OCR 모델 산출물, 따로 패키징된 ONNX Runtime을 묶은 것입니다. 이 확장은 MIT가 아닙니다. 재배포하거나 네트워크로 사용자에게 제공하면 AGPL-3.0 소스 공개 의무가 생길 수 있습니다. Cua는 이 검출기를 재라이선스하지 않으며 다른 조건을 줄 수 없습니다. 확장 산출물을 설치 · 재배포 · 호스팅하기 전에 perception 서드파티 고지와 주의사항을 읽으세요.

상표

Apple, macOS, Ubuntu, Canonical, Microsoft는 각 소유자의 상표입니다. 이 프로젝트는 이들 회사와 제휴하거나 보증을 받지 않았습니다.


저장소: https://github.com/trycua/cua

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0