Cua: AI 에이전트가 macOS/Lux 샌드박스에서 애플리케이션을 안전하게 실행할 수 있도록 지원

일반 소개

Cua는 "쿠아"로 발음되는 컴퓨터 사용 에이전트라는 오픈 소스 프로젝트입니다. Apple Silicon 디바이스용으로 설계되었으며, 고성능 macOS 및 Linux 가상 머신을 생성 및 실행할 수 있고, Apple의 가상화 프레임워크 기술을 사용하여 90%. Cua의 기본 디바이스에 가까운 속도를 지원하며, 가상 환경에서 웹 검색, 코드 작성 등의 작업을 수행할 수 있는 AI 에이전트를 지원합니다. 이 프로젝트는 사용자의 기본 시스템을 안전하게 격리하고 보호하는 데 중점을 두고 있습니다. 개발자, 기술 애호가, AI 연구자를 위한 MIT 라이선스로 GitHub에서 사용할 수 있습니다.

기능 목록

• Apple Silicon에서 macOS 및 Linux 가상 머신을 생성하고 실행합니다.
• 최대 90%의 기본 속도로 고성능 가상화를 제공합니다.
• 브라우징 및 인코딩과 같은 복잡한 작업을 위해 가상 머신의 AI 에이전트 제어를 지원합니다.
• 보안을 위해 가상 머신이 메인 시스템에서 완전히 격리되어 있는지 확인하세요.
• VM과 AI 에이전트를 쉽게 관리할 수 있도록 명령줄 도구(Lume CLI)와 Python 라이브러리가 제공됩니다.
• 다중 언어 모델(LLM) 통합 지원(예: OpenAI, Anthropic).
• 사용자가 가상 머신 이미지와 기능을 커스터마이징할 수 있는 오픈 소스 프레임워크입니다.

도움말 사용

Cua의 설치 및 사용은 가상 머신 관리(Lume CLI)와 전체 AI 에이전트 기능의 두 부분으로 나뉩니다. 자세한 단계는 다음과 같습니다.

시스템 요구 사항

• 장치: Apple Silicon이 탑재된 Mac(M1/M2/M3/M4).
• 시스템: macOS 14(Sonoma) 이상.
• Python: 3.10 이상(AI 에이전트 기능만 해당).
• 디스크 공간: 가상 머신 이미지를 저장하려면 40GB 이상을 권장합니다.

설치 프로세스

옵션 1: Lume CLI(가상 머신 관리)만 설치하기

1. 터미널을 열고 네트워크가 열려 있는지 확인합니다.
2. Lume을 설치하는 명령을 입력합니다:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

3. 설치가 완료되면 다음을 입력합니다. lume --version 버전을 확인하여 설치가 성공적으로 완료되었는지 확인합니다.

옵션 2: 전체 AI 에이전트 기능 설치

1. 위 단계와 같이 Lume CLI를 먼저 설치합니다.
2. Python 라이브러리를 설치합니다:

pip install cua-computer cua-agent

3. 더 많은 기능이 필요한 경우 다음과 같은 다른 라이브러리를 설치할 수 있습니다:

pip install cua-core cua-computer-server cua-som pylume

주요 기능

가상 머신 생성 및 실행

1. 터미널에 입력합니다:

lume run macos-sequoia-vanilla:latest

그러면 macOS Sequoia 가상 머신이 다운로드되고 실행됩니다.
2. 가상 머신이 시작되면 별도의 데스크톱이 표시됩니다.
3. Ctrl+C 가상 머신을 중지합니다.

AI 에이전트 사용

1. 구성 환경
   AI 에이전트 라이브러리를 설치한 후 .env 파일에 모델 키를 추가합니다. 예시:

OPENAI_API_KEY=你的密钥

2. 실행 예제
   GitHub의 notebooks 예를 들어 폴더에서 샘플 코드를 찾습니다:

• 터미널을 열고 실행합니다:

  python -m cua_agent.examples.basic_agent
  

• AI 에이전트는 스크린샷에서 VM 인터페이스를 인식하고 작업을 수행합니다.

3. 사용자 지정 작업
   Python 스크립트를 편집하여 웹 페이지 탐색이나 버튼 클릭과 같은 상담원의 특정 작업을 정의합니다.

가상 머신 관리

• 미러 목록::

lume images

• 미러 삭제::

lume rm macos-sequoia-vanilla:latest

주요 기능 작동

고성능 가상화

Cua는 추가 구성 없이도 네이티브에 가까운 성능을 달성하기 위해 Apple의 Virtualisation.Framework를 사용합니다. 긱벤치 테스트를 실행한 결과 가상 머신은 기본적으로 최대 90%의 성능을 발휘할 수 있는 것으로 나타났습니다.

안전한 격리

각 VM은 별도의 샌드박스에서 실행되며, AI 에이전트의 작동이 메인 시스템에 영향을 미치지 않으므로 안전하지 않은 코드나 애플리케이션을 테스트하는 데 적합합니다.

LLM 통합

Cua는 여러 언어 모델 연결을 지원합니다. 사용자는 해당 라이브러리를 설치하고 키를 구성하기만 하면 됩니다. 예를 들어

• 앤트로픽을 사용합니다:

pip install "cua-agent[anthropic]"
export ANTHROPIC_API_KEY=你的密钥

고급 사용

1. 문서 보기
   GitHub의 docs/Getting-Started.md 어쩌면 libs/*/README.md를 참조하세요.
2. 노트북 예제 실행
   다운로드 notebooks 폴더에서 GitHub 문제를 해결하거나 앱을 복제하는 AI 에이전트의 데모를 체험해 보세요.
3. 코드 기여
   상담 CONTRIBUTING.md를 클릭하고 새로운 기능을 제출하거나 문제를 해결하세요.

주의

• Apple 실리콘만 지원하며, Intel Mac과 호환되지 않습니다.
• 가상 머신 이미지가 큰 경우(예: macOS의 경우 20~30GB 필요) 디스크 공간이 충분한지 확인하세요.
• AI 에이전트에는 안정적인 네트워크와 유효한 API 키가 필요합니다.

애플리케이션 시나리오

1. 소프트웨어 개발 및 테스트
   개발자는 Cua를 사용하여 여러 가상 머신을 생성하여 macOS 및 Linux에서 애플리케이션을 테스트합니다.
2. AI 자동화된 작업
   웹 데이터 스크래핑 또는 문서 정리 작업을 자동화하도록 AI 에이전트를 구성하세요.
3. 교육 및 실험
   학생이나 연구원은 가상화 또는 AI 기술을 배우기 위해 격리된 환경에서 코드를 실행합니다.

QA

1. Cua는 어떤 운영 체제를 지원하나요?
   macOS와 Linux는 지원되지만 Windows는 지원되지 않습니다.
2. 가상 머신은 얼마나 빠르게 실행되나요?
   Apple 실리콘 및 가상화가 보장하는 네이티브에 가까운 90%.
3. 커뮤니티에 참여하려면 어떻게 해야 하나요?
   Discord(https://discord.com/invite/mVnXXpdE85)를 방문하여 아이디어를 공유하거나 도움을 요청하세요.