pip install falla con «externally-managed-environment» en Raspberry Pi OS

Al ejecutar pip install paquete sale error: externally-managed-environment y no se instala nada.

Por Kike · revisada en octubre de 2026 · Nivel: Básico · Cómo verificamos

Por qué pasa (diagnóstico)

• Desde Bookworm, el Python del sistema está protegido (PEP 668): pip ya no puede instalar fuera de un entorno virtual.
• Es un cambio de la comunidad de Python, no un fallo de la Pi.

Solución paso a paso

1. Si el paquete existe en apt, instálalo así: sudo apt install python3-nombre (p. ej. python3-numpy).
2. Si no, crea un entorno virtual en tu proyecto: python -m venv env.
3. Actívalo: source env/bin/activate y ahora sí pip install paquete.
4. Si necesitas también librerías del sistema (GPIO, cámara), créalo con python -m venv --system-site-packages env.
5. Evita --break-system-packages: puede romper el sistema.

Requisitos

• Raspberry Pi
• Raspberry Pi OS Bookworm o Trixie

Compatibilidad

• Raspberry Pi OS Bookworm
• Raspberry Pi OS Trixie
• Debian 12+

Verificación

Basado en la documentación oficial citada; aún no probado en este laboratorio.

Fuentes

• Raspberry Pi docs — Usar Python (pip y venv) (en inglés)

Guías relacionadas

• Guía: instalar Raspberry Pi OS con Raspberry Pi Imager paso a paso
• Mi Raspberry Pi 5 no detecta el SSD NVMe
• Aviso de bajo voltaje (rayo) o Raspberry Pi que se ralentiza
• Arrancar la Raspberry Pi 5 desde USB o SSD (BOOT_ORDER)
• IP fija en Raspberry Pi OS Bookworm/Trixie con nmcli
• No encuentro la IP de la Raspberry Pi en la red

Más guías de Raspberry Pi.