Configuracion en Windows

Vision general

YeePilot funciona en Windows 10 y Windows 11 con binarios nativos tanto para x86_64 como ARM64. Esta guia cubre la instalacion, configuracion del PATH, almacenamiento de credenciales y como obtener las funcionalidades completas del sandbox a traves de WSL2.

Requisitos del sistema

Instalacion

Descargar el binario

Aun no hay un script de instalacion automatizado para Windows. Descargue el binario manualmente desde la pagina de versiones (opens in new tab):

• yeepilot-windows-amd64.tar.gz para sistemas x86_64 estandar
• yeepilot-windows-arm64.tar.gz para dispositivos ARM64 (por ejemplo, Surface Pro X, laptops Snapdragon)

Extraer e instalar

1. Extraiga el archivo descargado. Puede usar el comando tar integrado de Windows en PowerShell:

tar xzf yeepilot-windows-amd64.tar.gz

2. Mueva el binario a una ubicacion permanente. Una opcion comun es C:\Program Files\YeePilot\:

New-Item -ItemType Directory -Force -Path "C:\Program Files\YeePilot"
Move-Item yeepilot.exe "C:\Program Files\YeePilot\yeepilot.exe"

3. Agregue el directorio a su PATH del sistema para poder ejecutar yeepilot desde cualquier lugar.

Agregar al PATH

Via Ajustes del Sistema (persistente)

1. Presione Win + S y busque "Variables de entorno".
2. Haga clic en Editar las variables de entorno del sistema.
3. Haga clic en Variables de entorno.
4. Bajo Variables de usuario (o Variables del sistema para todos los usuarios), seleccione Path y haga clic en Editar.
5. Haga clic en Nuevo y agregue C:\Program Files\YeePilot.
6. Haga clic en Aceptar en todos los dialogos.
7. Abra una nueva ventana de terminal para que el cambio tenga efecto.

Via PowerShell (usuario actual, persistente)

$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\YeePilot", "User")

Abra una nueva ventana de terminal despues de ejecutar este comando.

Verificar la instalacion

yeepilot version

Configuracion inicial

Ejecute la configuracion interactiva para configurar su proveedor de IA:

yeepilot setup

Esto crea su archivo de configuracion en %USERPROFILE%\.yeepilot\config.yaml (tipicamente C:\Users\SuNombre\.yeepilot\config.yaml).

Almacenamiento de credenciales

YeePilot usa la API de proteccion de datos de Windows (DPAPI) para almacenar de forma segura claves API y tokens de autenticacion. DPAPI cifra las credenciales usando su cuenta de usuario de Windows, por lo que solo son accesibles cuando ha iniciado sesion.

• No se requiere software adicional.
• Las credenciales se almacenan en un archivo cifrado dentro de su directorio de configuracion de YeePilot.
• El cifrado esta vinculado a su cuenta de usuario de Windows. Otros usuarios en la misma maquina no pueden descifrarlas.

Recomendaciones de terminal

La TUI de YeePilot requiere una terminal moderna con buen soporte de Unicode y color.

Instalar Windows Terminal

Si no tiene Windows Terminal instalado:

winget install Microsoft.WindowsTerminal

O descarguela desde la Microsoft Store (opens in new tab).

Limitaciones del sandbox

Windows nativo no soporta namespaces del kernel de Linux. YeePilot usa limites de recursos a nivel de proceso en Windows, que proporcionan proteccion basica:

• 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.
• Limites de tamano de archivo -- La creacion de archivos individuales esta limitada.

# %USERPROFILE%\.yeepilot\config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # No disponible en Windows
  max_cpu_seconds: 300
  max_memory_mb: 512

Para aislamiento completo de sandbox por namespaces, use WSL2 (vea a continuacion).

WSL2 para funcionalidades completas del sandbox

Windows Subsystem for Linux 2 (WSL2) proporciona un kernel Linux real en Windows, habilitando el sandbox completo por namespaces de YeePilot con aislamiento de usuario, PID, montaje y red.

Instalar WSL2

Si no tiene WSL2 instalado:

wsl --install

Esto instala WSL2 con Ubuntu por defecto. Reinicie su computadora cuando se le solicite.

Instalar YeePilot en WSL2

Abra su terminal de WSL2 e instale YeePilot usando el script de instalacion de Linux:

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

Dentro de WSL2, YeePilot tiene acceso al conjunto completo de funcionalidades de Linux:

• Aislamiento completo de sandbox por namespaces
• Almacenamiento de credenciales con GNOME Keyring (si esta configurado)
• Registro de auditoria resistente a manipulaciones con cadenas de hash

Acceder a archivos de Windows desde WSL2

Sus unidades de Windows estan montadas bajo /mnt/ en WSL2:

# Acceder a su directorio home de Windows
ls /mnt/c/Users/SuNombre/
 
# Ejecutar YeePilot contra archivos alojados en Windows
yeepilot run

Cuando usar WSL2 vs. Windows nativo

Ejecutar YeePilot como servicio

Si desea que las verificaciones de actualizacion automatica de YeePilot se ejecuten en segundo plano, puede usar el Programador de tareas de Windows. Sin embargo, para la mayoria de los usuarios, la verificacion automatica de actualizacion al inicio es suficiente.

Actualizacion

Verifique e instale actualizaciones:

yeepilot update

O verifique sin instalar:

yeepilot update --check

Para actualizar manualmente, descargue el nuevo binario desde la pagina de versiones y reemplace el archivo yeepilot.exe existente.

Desinstalacion

Elimine YeePilot y todos sus datos:

yeepilot uninstall --all

O elimine solo el binario:

yeepilot uninstall --binary-only

Para eliminacion manual:

1. Elimine el binario: C:\Program Files\YeePilot\yeepilot.exe
2. Elimine el directorio de configuracion: %USERPROFILE%\.yeepilot\
3. Elimine C:\Program Files\YeePilot de su PATH.

Si tambien instalo en WSL2, desinstale por separado desde dentro de la terminal de WSL2:

yeepilot uninstall --all