ONEDEV

cua

AI Agent SandboxesCLIHTML

★ 22,587주당 +1,823조회 9

무엇인가

Cua는 computer-use 에이전트에게 실제 컴퓨터를 붙이는 오픈소스 스택이다. 에이전트가 코드 실행, API 호출, 그래픽 인터페이스 조작을 같은 작업 안에서 오가는 Computer-Use 2.0 흐름을 전제로 한다. 에이전트와 모델은 사용자가 가져오고, Cua는 컴퓨터와 자동화 도구를 맡는 분업 구조이며, 격리 실행 환경 계열에 속한다.

어떻게 동작하나

구성 요소는 네 가지다. Cua Fleets는 run.cua.ai에서 격리된 클라우드 데스크톱 풀을 유지하고, 사용자 코드가 풀에서 데스크톱을 claim한 뒤 Sandbox SDK로 명령 실행, 스크린샷 캡처, 앱 조작을 수행한다. Cua Driver는 CLI, MCP, 타입 지정 SDK를 통해 macOS·Windows·Linux의 네이티브 앱과 브라우저를 검사·조작하며, background delivery로 포인터를 움직이거나 포커스를 빼앗지 않고 입력을 전달한다. Lume은 Apple Silicon에서 Apple Virtualization.Framework로 macOS·Linux VM을 생성·관리하고 SSH로 접속한다. Cua Bench는 computer-use 태스크를 작성하고 평가자를 돌려 궤적(trajectory)을 학습용으로 내보낸다.

무엇과 다른가

Fleets의 클라우드 데스크톱과 로컬 샌드박스는 같은 Sandbox SDK를 공유하지만 자격 증명, 이미지, 연산, 런타임 요구가 서로 다르다. Lume은 컨테이너가 아니라 Apple Virtualization.Framework 위의 VM이라 macOS 게스트를 돌릴 수 있다. Cua Bench는 VM이나 Docker, 모델 API 키 없이 시뮬레이션 태스크부터 시작하는 경로를 둔다.

어떻게 쓰나

첫 결과 경로는 구성 요소마다 정해져 있다. Fleets는 Linux 데스크톱을 프로비저닝하고 `uname -a`를 실행한 뒤 스크린샷을 저장하고 클라우드 리소스를 삭제한다. Driver는 에이전트를 연결해 Calculator에서 6 × 7을 계산시키고 앱이 42를 표시하는지 검증한다. Lume은 Apple restore image로 macOS Tahoe VM을 만들어 시작하고 SSH로 붙는다. Cua Bench는 Python 3.12 또는 3.13과 uv를 갖춘 뒤 태스크를 만들고 참조 솔루션을 실행해 평가자의 reward가 1.0인지 확인한다. Claude Code, Codex, Cursor, OpenClaw 같은 에이전트는 별도 통합 경로를 쓴다.

전제와 한계

제약은 플랫폼별로 갈린다. background delivery는 앱과 플랫폼이 지원하는 범위 안에서만 동작한다. Lume은 Apple Silicon을 요구한다. Fleets의 풀은 claim이 끝난 뒤에도 유료 용량을 유지할 수 있어 정리 절차를 따라야 한다. Cua Bench는 Python 3.12/3.13과 uv를 전제로 한다. 라이선스는 MIT이고, 선택적 `cua-agent[omni]`는 ultralytics(AGPL-3.0)를 포함한다.

관련 논문 2

유사 도구