Cómo instalar Python en Mac, actualizarlo y usar VENV (2026)

Si has intentado hacer pip install de algo en un Mac recientemente, te habrás topado con el error externally-managed-environment. Desde Python 3.12, Homebrew sigue PEP 668, lo que significa que los entornos virtuales ya no son opcionales. Son obligatorios. Esta guía te lleva paso a paso por cómo instalar Python en Mac con Homebrew, configurar tu PATH para que python funcione, actualizar entre versiones sin romper nada y configurar venv correctamente para tus proyectos.

Antes de empezar: requisitos previos

Comprueba tu versión de macOS y la arquitectura (Apple Silicon vs Intel)

Homebrew se instala en ubicaciones diferentes según el procesador de tu Mac:

Comprueba cuál tienes:

uname -m

• arm64 → Apple Silicon
• x86_64 → Intel

Si quieres una mejor experiencia de terminal antes de empezar, considera configurar primero un terminal de desarrollo moderno para Mac.

Instala Xcode Command Line Tools

macOS incluye su propio Python 3 (instalado mediante Xcode Command Line Tools, normalmente 3.9.x). Necesitas las CLT para que Homebrew funcione, pero no elimines el Python del sistema. Las herramientas de macOS dependen de él.

xcode-select --install

Haz clic en “Instalar” en el diálogo. Esto tarda unos minutos.

Verifica que se instaló:

xcode-select -p

Salida esperada: /Library/Developer/CommandLineTools

Instala Homebrew en Mac

Homebrew es el gestor de paquetes que hace que instalar Python sea sencillo. Si aún no lo tienes:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

En Apple Silicon, Homebrew añade su entrada de PATH a ~/.zprofile automáticamente. Sigue las instrucciones post-instalación que aparecen en el terminal. Puede que necesites ejecutar:

eval "$(/opt/homebrew/bin/brew shellenv)"

Comprueba que Homebrew está en buen estado:

brew doctor

Esperado: Your system is ready to brew.

Si estás personalizando tu shell, potencia tu terminal Zsh con plugins útiles y activa el resaltado de sintaxis en Zsh para una mejor experiencia.

Instala la última versión de Python en Mac con Homebrew

Con Homebrew listo, instala la última versión estable de Python:

brew install python

Esto instala Python 3.14.x (la versión estable actual a fecha de 2026), junto con pip, setuptools y wheel.

Verifica tu instalación de Python

Ejecuta estas comprobaciones para confirmar que todo funciona:

python3 --version
which python3
which pip3

Salida esperada:

Python 3.14.6
/opt/homebrew/bin/python3
/opt/homebrew/bin/pip3

Configura tu PATH para Python en Mac

Esto es lo que nadie te cuenta: después de brew install python, el comando python3 funciona, pero python NO. Verás:

zsh: command not found: python

Homebrew instala los enlaces simbólicos sin versión (python, pip) en un directorio aparte que no está en tu PATH por defecto. Arréglalo así:

# Añade los comandos sin versión del Python de Homebrew al PATH
echo 'export PATH="$(brew --prefix python)/libexec/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

Verifica:

python --version

Debería mostrar la misma versión que python3 --version.

Instala una versión específica de Python en Mac

A veces un proyecto requiere una versión específica de Python. Homebrew ofrece fórmulas versionadas para esto.

Cómo buscar versiones de Python disponibles en Homebrew

brew search python@

Verás entradas desde [email protected] hasta [email protected]. Para la lista actualizada con los números de versión exactos:

Instala la versión que necesites. Por ejemplo, Python 3.13:

brew install [email protected]

El comando versionado funciona inmediatamente después de la instalación:

python3.13 --version

Python 3.13.14

No hace falta enlazar nada. Puedes usar python3.13 directamente en tus comandos y entornos virtuales.

Enlazar fórmulas de Python keg-only

Las fórmulas versionadas de Python (como [email protected]) son “keg-only”. Homebrew no las enlaza a tu PATH por defecto. Si intentas hacer brew link de una y ya hay otra versión de Python enlazada, obtendrás un error:

Error: Cannot link [email protected]

Si realmente necesitas que python3 apunte a otra versión:

# Desenlaza primero la versión actual
brew unlink python

# Enlaza la versión que quieras
brew link --force [email protected]

Actualiza Python a la última versión en Mac

Aquí es donde la mayoría de las guías se equivocan, incluida la versión anterior de este artículo.

La verdad sobre brew upgrade python (versiones mayores vs. parches)

brew upgrade python no salta entre versiones mayores. Actualiza al último parche de la fórmula que tengas instalada.

# Actualiza el índice de paquetes de Homebrew
brew update

# Actualiza al último parche de la fórmula actual (p. ej., de 3.14.5 a 3.14.6)
brew upgrade python

Verifica:

python3 --version

Para saltar de una versión mayor a otra:

# Instala la nueva versión mayor
brew install [email protected]

# Úsala con el comando versionado
python3.14 --version

Fija Python para evitar actualizaciones accidentales

Cuando Homebrew actualiza otros paquetes, a veces puede actualizar Python como dependencia. Esto cambia la ruta del binario de Python, lo que rompe los entornos virtuales existentes. Fija tu versión de Python para evitarlo:

# Fijar evita actualizaciones accidentales
brew pin [email protected]

# Comprueba qué está fijado
brew list --pinned

# Desfíjala cuando estés listo para actualizar
brew unpin [email protected]

rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Entendiendo PEP 668: por qué necesitas entornos virtuales

Esta es la sección que me hubiera gustado encontrar cuando me topé con el error por primera vez. Si has intentado instalar un paquete de Python globalmente con pip y te has llevado un muro de texto rojo, aquí está el porqué.

El error externally-managed-environment explicado

Desde Python 3.12, Homebrew marca su instalación de Python como “gestionada externamente” (según PEP 668). Esto significa:

pip install requests

Da como resultado:

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to install.

Esto no es un bug. Es una protección deliberada. El Python de Homebrew está gestionado por Homebrew. Permitir que pip instale paquetes globalmente podría entrar en conflicto con los paquetes gestionados por Homebrew y romper tu sistema.

La solución: usa un entorno virtual (para las dependencias del proyecto) o pipx (para herramientas CLI). Ambos se cubren en las siguientes secciones.

Referencia: documentación de Homebrew and Python.

Ejecuta Python en VENV en Mac

Los entornos virtuales son ahora la forma estándar (y obligatoria) de gestionar las dependencias de proyectos Python. Este es el flujo de trabajo completo.

Crea un entorno virtual de Python en Mac

Ve al directorio de tu proyecto y crea un venv:

cd ~/my-project
python3 -m venv .venv

Activa y usa tu entorno virtual

source .venv/bin/activate

Tu prompt del terminal cambia para mostrar el entorno activo:

(.venv) user@mac my-project %

Verifica que funciona:

which python

Debería mostrar: /Users/youruser/my-project/.venv/bin/python

Ahora pip install funciona sin errores de PEP 668:

pip install requests

Instala paquetes y congela los requisitos

Este es el flujo de trabajo práctico que faltaba en el artículo antiguo:

# Instala paquetes dentro de tu venv activo
pip install requests pandas fastapi

# Congela las dependencias actuales en un archivo
pip freeze > requirements.txt

El archivo requirements.txt permite a cualquiera recrear el mismo entorno:

# En otra máquina (o tras clonar un repositorio):
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

uv pip install requests pandas
uv pip freeze > requirements.txt
uv venv  # crea venvs más rápido que python -m venv

Desactiva el entorno virtual

Cuando termines de trabajar:

deactivate

Tu prompt vuelve a la normalidad. Los paquetes permanecen instalados en .venv/. No se pierde nada.

Añade .venv a .gitignore

Nunca subas tu entorno virtual a git. Añade estas entradas a tu .gitignore:

.venv/
venv/
env/

Solución de problemas comunes de Python en Mac

echo 'export PATH="$(brew --prefix python)/libexec/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile
python --version

# Usa simplemente el comando versionado. No hace falta enlazar.
python3.13 --version
python3.13 -m venv .venv

brew unlink python
brew link --force [email protected]

python3 -m venv .venv
source .venv/bin/activate
pip install <package>

brew install pipx
pipx ensurepath
pipx install black

rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Alternativas a considerar

Homebrew es el camino más sencillo, pero no el único. Estas son las principales alternativas.

uv: un gestor de paquetes de Python moderno

uv, de Astral, es una herramienta de Python todo en uno que reemplaza a pip, venv, pyenv y pipx. Está escrita en Rust y es significativamente más rápida que pip.

brew install uv
uv venv           # crea venvs más rápido
uv pip install requests  # reemplazo directo de pip
uv python install 3.13   # instala versiones específicas de Python

Si quieres una sola herramienta que se encargue de todo lo cubierto en este artículo, uv merece un vistazo. Guía completa: uv, un gestor de paquetes de Python moderno. Para despliegue: despliega un proyecto Python con uv y Dokploy.

pyenv: gestiona múltiples versiones de Python

pyenv es para cuando necesitas cambiar entre versiones de Python con frecuencia en distintos proyectos. La propia documentación de Homebrew lo recomienda “si necesitas estabilidad en las versiones menores o de parche para entornos virtuales”.

brew install pyenv
pyenv install 3.13.14
pyenv install 3.14.6
pyenv global 3.14.6

pyenv gestiona las versiones independientemente de Homebrew, así que actualizar Homebrew no cambiará accidentalmente la versión de Python de tu proyecto. Supone más trabajo de configuración, pero más control.

Instaladores oficiales de Python.org

Python.org ofrece instaladores universal2 para macOS que funcionan tanto en Apple Silicon como en Intel. Son independientes, sin dependencia de Homebrew.

Usa esta opción si no quieres Homebrew en absoluto, o si necesitas una compilación específica de Python. La desventaja: configuración manual del PATH, sin actualizaciones automáticas, y no se integra con el ecosistema de Homebrew.

pipx: instala herramientas CLI de Python globalmente

pipx instala herramientas CLI de Python (como black, ruff, mypy, poetry) en entornos aislados, haciéndolas disponibles globalmente sin ensuciar el Python de tu sistema.

brew install pipx
pipx ensurepath
pipx install black
pipx install ruff

Siguientes pasos: qué construir con Python en Mac

Ahora que tienes Python instalado y sabes cómo gestionar entornos, estos son los próximos pasos:

• Explora los mejores frameworks web de Python: encuentra el framework adecuado para tu próximo proyecto
• Crea una UI para tu app Python con NiceGUI: guía de inicio rápido para apps Python con interfaz
• Añade varias páginas a tu app NiceGUI: continuación para proyectos NiceGUI
• Ejecuta tu app Python en Docker: conteneriza tu proyecto para despliegues consistentes
• Despliega un proyecto Python con uv y Dokploy: despliegue en producción en un VPS
• Genera imágenes con IA localmente con Python: ejecuta modelos Flux en tu Mac

Si vas a desplegar en un servidor, Hetzner ofrece VPS europeos asequibles que funcionan bien para apps Python.

Los precios de los VPS subieron en general en 2026 — si estás reconsiderando un servidor alquilado, mira qué cambió y cuándo gana un mini PC.