Cua: Permitir que los agentes de IA ejecuten aplicaciones de forma segura en entornos aislados de macOS/Linux

Introducción general

Cua es un proyecto de código abierto llamado Computer-Use Agent, pronunciado "koo-ah". Está diseñado para dispositivos Apple Silicon, puede crear y ejecutar máquinas virtuales macOS y Linux de alto rendimiento, velocidad cercana al dispositivo nativo de 90%. Cua utiliza la tecnología Virtualization.Framework de Apple, a la vez que soporta agentes de IA en el entorno virtual para realizar tareas como navegar por la web, escribir código. El proyecto hace hincapié en el aislamiento seguro y la protección del sistema principal del usuario. Está disponible en GitHub bajo licencia MIT para desarrolladores, entusiastas de la tecnología e investigadores de IA.

Lista de funciones

• Cree y ejecute máquinas virtuales macOS y Linux en Apple Silicon.
• Proporciona virtualización de alto rendimiento a velocidades nativas de hasta 90%.
• Admite el control de máquinas virtuales por agentes de IA para operaciones complejas como la navegación y la codificación.
• Asegúrese de que las máquinas virtuales están completamente aisladas del sistema principal por motivos de seguridad.
• Se proporcionan herramientas de línea de comandos (Lume CLI) y bibliotecas Python para facilitar la gestión de las máquinas virtuales y los agentes de IA.
• Soporte para la integración de múltiples modelos de lenguaje (LLM), por ejemplo OpenAI, Anthropic.
• Framework de código abierto que permite a los usuarios personalizar las imágenes y funciones de las máquinas virtuales.

Utilizar la ayuda

La instalación y uso de Cua se divide en dos partes: gestión de máquinas virtuales (Lume CLI) y funcionalidad completa del agente AI. A continuación se detallan los pasos.

requisitos del sistema

• Dispositivo: Mac con Apple Silicon (M1/M2/M3/M4).
• Sistema: macOS 14 (Sonoma) o posterior.
• Python: 3.10 o superior (sólo funcionalidad de agente de IA).
• Espacio en disco: se recomiendan 40 GB o más para almacenar imágenes de máquinas virtuales.

Proceso de instalación

Opción 1: Instalar sólo Lume CLI (Gestión de Máquinas Virtuales)

1. Abra el terminal y asegúrese de que la red está abierta.
2. Introduzca el comando para instalar Lume:

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

3. Una vez finalizada la instalación, introduzca lume --version Compruebe la versión para asegurarse de que la instalación se ha realizado correctamente.

Opción 2: Instalar la funcionalidad completa del Agente AI

1. Instale primero el Lume CLI (como en los pasos anteriores).
2. Instale la biblioteca Python:

pip install cua-computer cua-agent

3. Si necesitas más funcionalidad, puedes instalar otras librerías como:

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

Funciones principales

Creación y ejecución de máquinas virtuales

1. Introdúcelo en el terminal:

lume run macos-sequoia-vanilla:latest

Esto descargará e iniciará la máquina virtual macOS Sequoia.
2. Cuando se inicie la máquina virtual, verá un escritorio independiente.
3. Pulse Ctrl+C Detener la máquina virtual.

Uso del agente de IA

1. Entorno de configuración
   Después de instalar la biblioteca de agentes AI, cree .env añada la clave del modelo. Ejemplo:

OPENAI_API_KEY=你的密钥

2. ejemplo de funcionamiento
   En GitHub notebooks Busque el código de ejemplo en la carpeta, por ejemplo

• Abre un terminal y ejecútalo:

  python -m cua_agent.examples.basic_agent
  

• El agente de IA reconoce la interfaz de la máquina virtual a partir de la captura de pantalla y realiza la tarea.

3. Tareas personalizadas
   Edite el script Python para definir acciones específicas del agente, como navegar por una página web o pulsar un botón.

Gestión de máquinas virtuales

• Lista de espejos::

lume images

• Borrar espejo::

lume rm macos-sequoia-vanilla:latest

Función destacada Operación

Virtualización de alto rendimiento

Cua utiliza Virtualisation.Framework de Apple para conseguir un rendimiento casi nativo sin necesidad de configuración adicional. Las pruebas de Geekbench muestran que la máquina virtual puede rendir hasta 90% de forma nativa.

aislamiento seguro

Cada máquina virtual se ejecuta en un espacio aislado. El funcionamiento del agente de IA no afecta al sistema principal, por lo que resulta adecuado para probar código o aplicaciones inseguros.

Integración LLM

Cua admite la conexión de varios modelos lingüísticos. Los usuarios sólo tienen que instalar la biblioteca correspondiente y configurar la clave. Por ejemplo:

• Usa Antrópico:

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

Uso avanzado

1. Ver documento
   Visite la página de GitHub docs/Getting-Started.md tal vez libs/*/README.mdpara más detalles sobre su uso.
2. Ejecutar el ejemplo de Notebook
   descargando notebooks en Jupyter Notebook para experimentar una demostración del agente de IA solucionando un problema de GitHub o clonando una aplicación.
3. Aportar código
   consulta CONTRIBUTING.mdEnvía nuevas funciones o soluciona problemas.

advertencia

• Sólo compatible con Apple Silicon, no compatible con Mac Intel.
• Las imágenes de máquinas virtuales más grandes (por ejemplo, macOS requiere 20-30 GB), asegúrese de que tiene suficiente espacio en disco.
• Los agentes de IA requieren una red estable y una clave API válida.

escenario de aplicación

1. Desarrollo y pruebas de software
   Los desarrolladores utilizan Cua para crear varias máquinas virtuales para probar aplicaciones en macOS y Linux.
2. AI Trabajo automatizado
   Configure un agente de IA para automatizar tareas de raspado de datos web u organización de documentos.
3. Educación y experimentación
   Estudiantes o investigadores ejecutan código en entornos aislados para aprender técnicas de virtualización o IA.

CONTROL DE CALIDAD

1. ¿Qué sistemas operativos admite Cua?
   macOS y Linux son compatibles, Windows no.
2. ¿A qué velocidad funciona la máquina virtual?
   90% casi nativo, garantizado por Apple Silicon y Virtualisation.
3. ¿Cómo me uno a la comunidad?
   Visita Discord (https://discord.com/invite/mVnXXpdE85) para compartir ideas o pedir ayuda.