Configuracion en macOS

Vision general

YeePilot se ejecuta de forma nativa en macOS con soporte tanto para Macs Intel como Apple Silicon. Esta guia cubre la instalacion, integracion con Keychain, permisos de Gatekeeper y consideraciones especificas de macOS.

Requisitos del sistema

Instalacion

Instalacion rapida (recomendada)

El script de instalacion detecta automaticamente la arquitectura de su Mac e instala el binario correcto:

curl -fsSL https://yee.to/install.sh | bash

Esto hara lo siguiente:

1. Detectar si esta en Intel o Apple Silicon.
2. Descargar el binario nativo apropiado.
3. Verificar el checksum de la descarga.
4. Instalar el binario en /usr/local/bin/yeepilot.

Despues de la instalacion, verifique que funciona:

yeepilot version

Instalacion manual

1. Descargue el archivo correcto desde la pagina de versiones (opens in new tab):

   • yeepilot-darwin-amd64.tar.gz para Macs Intel
   • yeepilot-darwin-arm64.tar.gz para Macs Apple Silicon (M1, M2, M3, M4)

2. Extraiga e instale:

tar xzf yeepilot-darwin-arm64.tar.gz
sudo mv yeepilot /usr/local/bin/
sudo chmod +x /usr/local/bin/yeepilot

3. Verifique la instalacion:

yeepilot version

Permisos de Gatekeeper

El Gatekeeper de macOS puede bloquear YeePilot la primera vez que lo ejecute porque el binario no esta firmado con un certificado de Apple Developer. Vera un mensaje como: "yeepilot" cannot be opened because the developer cannot be verified.

Permitir via Ajustes del Sistema

1. Abra Ajustes del Sistema (o Preferencias del Sistema en macOS mas antiguo).
2. Vaya a Privacidad y seguridad.
3. Desplacese hacia abajo hasta la seccion de Seguridad.
4. Deberia ver un mensaje sobre yeepilot siendo bloqueado. Haga clic en Permitir igualmente.
5. Ejecute yeepilot version nuevamente y haga clic en Abrir en el dialogo de confirmacion.

Permitir via Terminal

Alternativamente, elimine el atributo de cuarentena directamente:

xattr -d com.apple.quarantine /usr/local/bin/yeepilot

Esto solo necesita hacerse una vez. Las actualizaciones posteriores pueden requerir repetir este paso.

Configuracion inicial

Ejecute la configuracion interactiva para configurar su proveedor de IA:

yeepilot setup

Esto crea su archivo de configuracion en ~/.yeepilot/config.yaml.

Almacenamiento de credenciales

YeePilot usa automaticamente el Keychain de macOS para almacenar claves API y tokens de autenticacion. Esto proporciona almacenamiento seguro y cifrado que se integra con el inicio de sesion de su sistema.

• Las credenciales se almacenan en el keychain de inicio de sesion predeterminado.
• Puede ver un prompt de Acceso a Keychain la primera vez que YeePilot almacena o recupera una credencial. Haga clic en Permitir siempre para evitar prompts repetidos.
• Las credenciales se etiquetan con yeepilot en Acceso a Keychain para facil identificacion.

Ver credenciales almacenadas

Abra Acceso a Keychain (en Aplicaciones > Utilidades) y busque yeepilot para ver las credenciales almacenadas.

No se requiere configuracion adicional

A diferencia de Linux, no se necesitan paquetes adicionales para el almacenamiento de credenciales en macOS. El Keychain esta disponible en todas las instalaciones de macOS.

Limitaciones del sandbox

macOS no soporta namespaces del kernel de Linux. YeePilot usa limites de recursos a nivel de proceso en su lugar, que proporcionan aislamiento basico:

• Limites de tiempo de CPU -- Los comandos se terminan si exceden el tiempo de CPU configurado.
• Limites de memoria -- La memoria del proceso se limita al maximo configurado.
• Limites de tamano de archivo -- La creacion de archivos individuales esta limitada.

Para configurar los ajustes del sandbox:

# ~/.yeepilot/config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # No disponible en macOS, deshabilitado automaticamente
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64

Tenga en cuenta que use_namespaces se establece automaticamente en false en macOS independientemente del valor de configuracion. No se requiere ninguna accion de su parte.

Para aislamiento completo por namespaces, considere ejecutar YeePilot dentro de una maquina virtual Linux o contenedor Docker en su Mac.

Notas sobre Apple Silicon

YeePilot proporciona un binario arm64 nativo para Macs Apple Silicon (serie M1, M2, M3, M4). Este se ejecuta sin traduccion Rosetta 2, asegurando un rendimiento optimo.

Para confirmar que esta ejecutando el binario nativo:

file $(which yeepilot)

Deberia ver una salida que contiene arm64 para Apple Silicon o x86_64 para Intel.

Si instalo accidentalmente la version Intel en un Mac Apple Silicon, seguira funcionando a traves de Rosetta 2, pero se recomienda reinstalar con la arquitectura correcta:

curl -fsSL https://yee.to/install.sh | bash

El script de instalacion siempre detecta e instala la arquitectura correcta.

Recomendaciones de terminal

La TUI de YeePilot funciona mejor con terminales que soportan:

• 256 colores o color verdadero -- Para la renderizacion correcta de temas.
• Unicode -- Para caracteres de dibujo de cajas e indicadores de estado.
• Redimensionamiento -- La TUI se adapta a cambios de tamano del terminal.

Todas las terminales populares de macOS funcionan bien:

Actualizacion

Actualice a la ultima version:

yeepilot update

Puede necesitar volver a permitir el binario en Gatekeeper despues de una actualizacion (vea la seccion de Permisos de Gatekeeper arriba).

Desinstalacion

Elimine YeePilot y todos sus datos:

yeepilot uninstall --all

O elimine solo el binario manteniendo su configuracion:

yeepilot uninstall --binary-only

Para una eliminacion manual:

sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Las entradas almacenadas en el Keychain pueden eliminarse manualmente a traves de Acceso a Keychain buscando yeepilot y eliminando las entradas correspondientes.