Python venv pip uv CHEATSHEET

Que resuelve

Referencia para crear entornos Python, instalar dependencias y trabajar con pip o uv sin romper el sistema.

venv

Crear entorno

python3 -m venv .venv

Activar en Linux/macOS

source .venv/bin/activate

Activar en PowerShell

.venv\Scripts\Activate.ps1

Ver Python activo

which python

Salir del entorno

deactivate

pip

Actualizar pip

python -m pip install --upgrade pip

Instalar paquete

python -m pip install {PACKAGE}

Instalar requirements

python -m pip install -r requirements.txt

Guardar dependencias

python -m pip freeze > requirements.txt

Ver paquetes

python -m pip list

Desinstalar

python -m pip uninstall {PACKAGE}

uv

Crear entorno con uv

uv venv

Instalar paquete

uv pip install {PACKAGE}

Instalar requirements

uv pip install -r requirements.txt

Ejecutar comando en entorno

uv run python {SCRIPT}.py

Crear proyecto

uv init {PROJECT}

pyproject.toml

Instalar proyecto editable

python -m pip install -e .

Instalar extras

python -m pip install -e '.[dev]'

Diagnostico

Version de Python

python --version

Donde esta instalado un paquete

python -m pip show {PACKAGE}

Comprobar import

python -c 'import {MODULE}; print({MODULE}.__file__)'

Ver sys.path

python -c 'import sys; print("\n".join(sys.path))'

Buenas practicas

• Un .venv por proyecto.

• No instales dependencias del proyecto en Python del sistema.

• Usa python -m pip para evitar pip equivocado.

• Versiona requirements.txt o pyproject.toml.

• No subas .venv al repositorio.

.gitignore

.venv/
__pycache__/
*.pyc
.pytest_cache/

Variables

Variable	Descripcion
{PACKAGE}	Paquete pip
{MODULE}	Modulo importable
{SCRIPT}	Script Python
{PROJECT}	Nombre del proyecto

Errores comunes

Sintoma	Causa probable	Solucion
ModuleNotFoundError	Entorno no activado	Activa .venv o usa uv run
pip instala en otro sitio	pip equivocado	Usa python -m pip
Permisos en sistema	Instalacion global	Usa venv
Version incompatible	Python distinto	Fija version del proyecto

Checklist final

• .venv creado.

• Entorno activado.

• Dependencias instaladas.

• Requirements o pyproject actualizado.

• .venv ignorado por Git.

- EOF -