Guías

Actualizaciones y solucion de problemas

Actualice YeePilot, solucione problemas comunes y gestione su instalacion

Última actualización: 1 de marzo de 2026

Actualizar YeePilot

YeePilot incluye un actualizador integrado que descarga e instala nuevas versiones directamente desde la linea de comandos.

Verificar actualizaciones

Vea si hay una nueva version disponible sin instalarla:

bash

yeepilot update --check

Esto muestra la version actual, la ultima version disponible y que ha cambiado.

Instalar la ultima version

Descargue e instale la ultima version:

bash

yeepilot update

El actualizador:

Verificara la ultima version.
Descargara el binario para su plataforma.
Verificara el checksum de la descarga.
Reemplazara el binario actual.

Forzar reinstalacion

Si su instalacion esta corrupta o desea reinstalar la misma version:

bash

yeepilot update --force

Esto descarga e instala la ultima version incluso si ya esta actualizado.

Revertir a version anterior

Si una nueva version introduce un problema, revierta a la version anteriormente instalada:

bash

yeepilot update --rollback

YeePilot mantiene una copia de seguridad del binario anterior para hacer posibles las reversiones. La reversion solo esta disponible para la actualizacion mas reciente -- no puede revertir multiples versiones.

Actualizaciones automaticas

Por defecto, YeePilot verifica actualizaciones automaticamente cada hora y le notifica cuando una nueva version esta disponible.

Configuracion

yaml

# ~/.yeepilot/config.yaml
update:
  auto_check: true
  check_interval_hours: 1

Deshabilitar verificaciones automaticas de actualizacion

Si prefiere gestionar las actualizaciones manualmente:

yaml

update:
  auto_check: false

O via variable de entorno:

bash

export YEEPILOT_UPDATE_AUTO_CHECK=false

Ajustar frecuencia de verificacion

Verifique con menos frecuencia para reducir solicitudes de red:

yaml

update:
  check_interval_hours: 24  # Una vez al dia

Solucion de problemas comunes

"Connection refused" o "Connection timed out"

Sintomas: YeePilot no puede alcanzar la API del proveedor de IA.

Causas y soluciones:

Clave API invalida -- Verifique que su clave API sea correcta:
bash
```
yeepilot status
```
Si la clave es incorrecta, reconfigurela:
bash
```
yeepilot setup --auth
```
URL de proveedor incorrecta -- Si usa una base_url personalizada, verifique que sea accesible:
bash
```
curl -I https://api.openai.com/v1/models
```
Problemas de red -- Verifique su conexion a internet y cualquier configuracion de proxy/firewall. Si esta detras de un proxy corporativo, asegurese de que permita trafico HTTPS al endpoint de API de su proveedor de IA.
Sandbox bloqueando red -- Si sandbox.network_access esta establecido en false, los comandos ejecutados por YeePilot no pueden acceder a la red. Sin embargo, las propias llamadas API de YeePilot no se ven afectadas por los ajustes del sandbox. Es mas probable que este error sea de la configuracion de red.

"Model not found" o "Invalid model"

Sintomas: El proveedor de IA rechaza el ID del modelo.

Causas y soluciones:

ID de modelo incorrecto -- Los identificadores de modelo son especificos del proveedor. Verifique que esta usando el formato correcto:

Proveedor Ejemplo de ID de modelo
OpenAI gpt-4o, gpt-4o-mini
Anthropic claude-sonnet-4-20250514
OpenRouter openai/gpt-4o, anthropic/claude-sonnet-4-20250514
Acceso al modelo no habilitado -- Algunos modelos requieren aprobacion de acceso explicita del proveedor. Verifique el panel de control de su proveedor para asegurarse de que tiene acceso al modelo.

Proveedor	Ejemplo de ID de modelo
OpenAI	`gpt-4o`, `gpt-4o-mini`
Anthropic	`claude-sonnet-4-20250514`
OpenRouter	`openai/gpt-4o`, `anthropic/claude-sonnet-4-20250514`

Incompatibilidad de proveedor -- Asegurese de que el ID del modelo coincida con su proveedor configurado. Un ID de modelo de Anthropic no funcionara con un ajuste de proveedor de OpenAI.

yaml

# Correcto: modelo coincide con proveedor
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
 
# Incorrecto: modelo de Anthropic con proveedor OpenAI
ai:
  provider: openai
  model: claude-sonnet-4-20250514

"Permission denied"

Sintomas: YeePilot no puede ejecutar comandos o acceder a archivos.

Causas y soluciones:

Permisos del binario -- El binario de YeePilot necesita permiso de ejecucion:
bash
```
chmod +x /usr/local/bin/yeepilot
```
Ubicacion de instalacion -- Si instalar en /usr/local/bin/ requiere root, use sudo:
bash
```
sudo curl -fsSL https://yee.to/install.sh | bash
```

Rutas denegadas del sandbox -- Verifique si la ruta objetivo esta en su lista sandbox.denied_paths:

yaml

sandbox:
  denied_paths:
    - "/etc/shadow"  # Los comandos no pueden acceder a esta ruta

Propiedad de archivos -- Asegurese de que el directorio de configuracion sea propiedad de su usuario:
bash
```
ls -la ~/.yeepilot/
# Si es propiedad de root:
sudo chown -R $(whoami) ~/.yeepilot/
```

"Keyring not available" o errores de almacenamiento de credenciales

Sintomas: YeePilot no puede almacenar o recuperar claves API del llavero del sistema.

Causas y soluciones:

Linux: Instalar libsecret-tools

bash

# Ubuntu / Debian
sudo apt install libsecret-tools
 
# Fedora / CentOS
sudo dnf install libsecret
 
# Arch
sudo pacman -S libsecret

Servidor Linux sin interfaz grafica: Sin demonio de llavero -- En servidores sin entorno de escritorio, YeePilot recurre a un archivo JSON cifrado en ~/.yeepilot/credentials.json. Si esta alternativa no funciona, asegurese de que el directorio de configuracion exista y sea escribible:
bash
```
mkdir -p ~/.yeepilot
chmod 700 ~/.yeepilot
```
macOS: Prompt de Acceso a Keychain -- Si los prompts del Keychain aparecen repetidamente, haga clic en Permitir siempre para otorgar a YeePilot acceso permanente.
Use variables de entorno como alternativa -- Si el almacenamiento de credenciales sigue causando problemas, establezca su clave API via variable de entorno:
bash
```
export OPENAI_API_KEY=sk-...
```

Errores del sandbox

Sintomas: Los comandos fallan con errores relacionados con namespaces o sandbox.

Causas y soluciones:

User namespaces deshabilitados -- Algunos kernels Linux o configuraciones reforzadas deshabilitan los user namespaces. Verifique:
bash
```
cat /proc/sys/kernel/unprivileged_userns_clone
```
Si la salida es 0, habilitelo:
bash
```
sudo sysctl kernel.unprivileged_userns_clone=1
```
O deshabilite el sandboxing por namespaces:
yaml
```
sandbox:
  use_namespaces: false
```
macOS o Windows -- El sandboxing por namespaces no esta disponible en estas plataformas. YeePilot lo deshabilita automaticamente, pero si ve errores, establezca explicitamente:
yaml
```
sandbox:
  use_namespaces: false
```

Sandbox demasiado restrictivo -- Si comandos legitimos estan siendo bloqueados, ajuste los limites:

yaml

sandbox:
  max_cpu_seconds: 600    # Aumentar de 300
  max_memory_mb: 1024     # Aumentar de 512
  max_processes: 128      # Aumentar de 64

"Token limit exceeded" o contexto demasiado grande

Sintomas: El proveedor de IA rechaza solicitudes porque el mensaje es demasiado largo.

Causas y soluciones:

Reducir historial de conversacion -- Menos mensajes significa menos contexto a enviar:
yaml
```
ai:
  conversation_max_history: 5
```
Reducir truncamiento de salida -- Limitar cuanta salida de comandos se incluye:
yaml
```
ai:
  output_truncate_length: 200
```
Habilitar modo de ahorro de tokens -- Comprime el contexto mas agresivamente:
yaml
```
ai:
  token_mode: saver
```
Iniciar una nueva sesion -- Si la sesion actual ha acumulado demasiado contexto, comience de nuevo. La IA no traslada contexto entre sesiones.

Problemas de visualizacion de la TUI

Sintomas: Salida distorsionada, caracteres de dibujo de cajas rotos o colores faltantes.

Causas y soluciones:

Use una terminal moderna -- Las terminales antiguas pueden no soportar Unicode o color verdadero. En Windows, use Windows Terminal. En Linux, use cualquier emulador de terminal moderno (GNOME Terminal, Konsole, Alacritty, Kitty).
Verifique la configuracion de locale -- Asegurese de que su locale soporte UTF-8:
bash
```
locale
```
Si LANG no termina en .UTF-8, configurelo:
bash
```
export LANG=en_US.UTF-8
```
Cambie de tema -- Si los colores se ven mal, pruebe un tema diferente:
yaml
```
tui:
  theme: dark  # o light, neon, auto
```
Deshabilite el panel de transmision en vivo -- Si el panel en vivo causa parpadeo:
yaml
```
tui:
  live_stream_panel_enabled: false
```

Restablecer la configuracion

Si su archivo de configuracion esta corrupto o desea comenzar de nuevo:

bash

yeepilot setup --reset

Esto regenera ~/.yeepilot/config.yaml con valores predeterminados y le guia a traves del asistente de configuracion nuevamente.

Para restablecer manualmente, elimine el archivo de configuracion y ejecute setup:

bash

rm ~/.yeepilot/config.yaml
yeepilot setup

Desinstalar YeePilot

Desinstalacion completa

Elimine el binario, configuracion, registros de auditoria, boveda y todos los datos almacenados:

bash

yeepilot uninstall --all

Mantener la configuracion

Elimine el binario pero conserve sus archivos de configuracion (util si planea reinstalar):

bash

yeepilot uninstall --keep-config

Solo el binario

Elimine solo el binario, dejando todo lo demas intacto:

bash

yeepilot uninstall --binary-only

Desinstalacion manual

Si el comando uninstall no esta disponible o falta el binario:

Linux/macOS:

bash

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

Windows (PowerShell):

powershell

Remove-Item "C:\Program Files\YeePilot\yeepilot.exe"
Remove-Item -Recurse "$env:USERPROFILE\.yeepilot"

Recuerde tambien eliminar C:\Program Files\YeePilot de su PATH en Windows.

Obtener ayuda

Si encuentra un problema no cubierto aqui:

Verifique la version -- Asegurese de que esta ejecutando la ultima version:
bash
```
yeepilot update
```
Verifique el estado -- Revise su configuracion activa:
bash
```
yeepilot status
```
Revise el registro de auditoria -- El registro de auditoria puede contener detalles de errores:
bash
```
tail -50 ~/.yeepilot/audit.log
```
Visite el sitio web -- Consulte yee.to (opens in new tab) para la documentacion mas reciente y anuncios.

Mejores practicas

Guides