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 “Python”, 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