Configura Python 3.13 y uv en macOS

Basic python

Configura Python 3.13 y uv en macOS

Objetivos de esta página #

  • Instalar Python 3.13 y uv en macOS Ventura / Sonoma
  • Crear un entorno virtual y gestionar librerías
  • Conocer los puntos clave para integrarlo con editores como VS Code

Requisitos previos #

ElementoDetalles
Herramienta necesariaHomebrew (verifica con brew --version. Si no está instalado, sigue la guía oficial)
Shellzsh (por defecto) o bash. Esta guía asume zsh
Carpeta de trabajoUsaremos ~/Projects/my-app

1. Instalar Python 3.13 #

brew update
brew install python@3.13
brew link python@3.13
python3.13 --version

Deberías ver Python 3.13.x. Si otra versión está enlazada, cambia con brew unlink python@3.x.

2. Instalar uv #

curl -LsSf https://astral.sh/uv/install.sh | sh

Comprueba el comando:

uv --version

Si uv no aparece, añade ~/.local/bin al PATH.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. Crear la carpeta del proyecto y el entorno virtual #

mkdir -p ~/Projects/my-app
cd ~/Projects/my-app
uv venv --python 3.13 .venv
source .venv/bin/activate

Cuando el prompt muestre (.venv), el entorno está activo. Usa deactivate para salir.

💡 También puedes ejecutar comandos sin activarlo: uv run python script.py utilizará el entorno automáticamente.

4. Añadir / sincronizar librerías #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt
  • uv pip install: agrega librerías
  • uv pip list: revisa las instaladas
  • uv pip sync: reconstruye a partir de requirements.txt

5. Integración con VS Code #

  1. Abre VS Code y en la paleta de comandos (⇧⌘P) elige Python: Select Interpreter
  2. Selecciona .venv/bin/python para que el editor use ese entorno
  3. Extensiones recomendadas: Python, Pylance, Black Formatter, Flake8 / Ruff

6. Problemas frecuentes #

ProblemaSolución
command not found: brewHomebrew no está instalado. Instálalo desde el script oficial
uv no se encuentraAñade el PATH en ~/.zshrc (u otro archivo rc) y ejecuta source
Error de permisos al crear el entornoVerifica los permisos del directorio (chmod, chown) y vuelve a intentar

7. Limpieza #

  • Salir del entorno: deactivate
  • Eliminar el entorno: rm -rf .venv
  • Guardar el listado de paquetes: uv pip freeze > requirements.txt

Ahora macOS ya cuenta con Python 3.13 + uv. Compáralo con las otras guías si lo necesitas:

Cuando est?s listo, contin?a con la siguiente lecci?n para empezar a aprender Python.

Siguiente paso: Empieza a aprender Python