Usando uv
Los comandos que usarás cada día con uv. Una vez que adoptas este flujo, es difícil volver a pip.
1. Crear y Gestionar Proyectos
# Crear un proyecto nuevo (crea carpeta + pyproject.toml + .venv)
uv init mi-proyecto
cd mi-proyecto
# Inicializar uv en un proyecto existente
uv init
# Ver la estructura generada
# mi-proyecto/
# ├── .venv/ # Entorno virtual (creado automáticamente)
# ├── pyproject.toml # Definición del proyecto y dependencias
# ├── uv.lock # Lock file con versiones exactas
# └── main.py # Fichero de muestra
2. Instalar Paquetes
# Añadir una dependencia (se añade al pyproject.toml)
uv add requests
uv add pandas numpy
uv add openai python-dotenv
# Añadir dependencia solo para desarrollo (no va a producción)
uv add --dev pytest ruff
# Eliminar un paquete
uv remove requests
# Instalar todo desde pyproject.toml (como pip install -r requirements.txt)
uv sync
3. Ejecutar Código con uv
No necesitas activar el entorno virtual manualmente. uv run lo gestiona automáticamente:
# Ejecutar un script
uv run main.py
uv run python main.py
# Ejecutar en modo interactivo
uv run python
# Ejecutar una herramienta sin instalarla permanentemente
uv run --with black black mi_fichero.py
# Equivalente al antiguo: source .venv/bin/activate && python main.py
4. Gestionar Versiones de Python
# Instalar una versión específica de Python
uv python install 3.12
uv python install 3.11 3.12
# Crear proyecto con versión específica
uv init --python 3.12 mi-proyecto
# Ver versiones disponibles
uv python list
# Fijar versión en el proyecto actual
uv python pin 3.12
uv gestiona las instalaciones de Python de forma completamente separada a la del sistema. No afecta a Python global ni a otros proyectos.
¿Listo para convertirte en un Maestro?
Potencia tu carrera con el Máster Completo: Python de la A a la Z. Domina Ciencia de Datos, ML y Deep Learning.