Configurar uv en Ubuntu

Objetivos de esta pﾃ｡gina #

Instalar Python 3.13 y uv en Ubuntu 22.04 / 24.04 LTS
Crear, activar y administrar un entorno virtual para tus proyectos de estudio
Identificar los puntos conflictivos habituales y saber quﾃｩ comprobar si algo falla

Requisitos previos #

Elemento	Detalles
Privilegios	Poder ejecutar `sudo` para gestionar paquetes
Terminal	ﾃ｜rela con Ctrl + Alt + T o desde el menﾃｺ de aplicaciones
Carpeta de trabajo	Ejemplo: `~/projects/my-app` (ajﾃｺstala si lo prefieres)

1. Instalar Python 3.13 #

Los repositorios estﾃ｡ndar de Ubuntu aﾃｺn no incluyen Python 3.13, asﾃｭ que aﾃｱade el PPA deadsnakes.

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev python3.13-distutils
python3.13 --version

Si aparece Python 3.13.x, la instalaciﾃｳn fue correcta.

2. Instalar uv #

curl -LsSf https://astral.sh/uv/install.sh | sh
~/.local/bin/uv --version

Si no se encuentra el comando, aﾃｱade ~/.local/bin al PATH:

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

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

Ver (.venv) en el prompt indica que el entorno estﾃ｡ activo. Usa deactivate para salir.

庁 Tambiﾃｩn puedes ejecutar uv run python script.py sin activar el entorno; uv lo usarﾃ｡ automﾃ｡ticamente.

4. Aﾃｱadir y sincronizar librerﾃｭas #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt

uv pip install: agrega paquetes
uv pip list: revisa los instalados
uv pip sync: reconstruye el entorno segﾃｺn requirements.txt

5. Integrar con editores (VS Code, etc.) #

En VS Code instala la extensiﾃｳn 窶弃ython窶・ presiona Ctrl+Shift+P, elige Python: Select Interpreter y selecciona .venv/bin/python.
Si usas editores en terminal (vim, neovim), ﾃ｡brelos desde la shell con el entorno activado.

6. Problemas habituales #

Problema	Soluciﾃｳn
Falta `add-apt-repository`	Ejecuta `sudo apt install software-properties-common`
`uv` sigue fuera del PATH	Aﾃｱade `~/.local/bin` al PATH y recarga la shell
`Permission denied` al crear `.venv`	Comprueba la propiedad de la carpeta (`ls -ld .`) y usa `chown` si es necesario

7. Limpieza #

Salir del entorno: deactivate
Eliminar el entorno: rm -rf .venv
Registrar dependencias: uv pip freeze > requirements.txt

Ahora Ubuntu estﾃ｡ listo con Python 3.13 + uv. Para comparar, revisa tambiﾃｩn las guﾃｭas de Windows y macOS, y continﾃｺa con el capﾃｭtulo de sintaxis para empezar a programar.

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

Siguiente paso: Empieza a aprender Python