Principiante absoluto⏱ 90 minPaso a paso

Crear un entorno virtual y aprender a diagnosticar

Crear .venv, instalar una dependencia, seleccionar el intérprete y resolver errores básicos.

Siguiente acción: Abre la carpeta del proyecto y confirma que la terminal está dentro de ella con pwd o Get-Location.

!

Cómo utilizar esta lección

Haz un paso a la vez. Después de cada paso compara tu pantalla con el resultado esperado.

No marques el checklist por leer: márcalo únicamente después de probar.

🎯 Al terminar podrás

Crear .venv, instalar una dependencia, seleccionar el intérprete y resolver errores básicos.

Palabras nuevas

venv
activation
pip
requirements
stack trace
breakpoint

🧭 Instrucciones paso a paso

Resultado esperado: La ruta termina en python-ai-course o el proyecto actual.

Antes de continuar: No crees .venv en tu carpeta personal completa.

Resultado esperado: Aparece una carpeta .venv en Explorer.

Antes de continuar: No edites manualmente archivos dentro de .venv.

Resultado esperado: El prompt suele mostrar (.venv).

Antes de continuar: Si PowerShell bloquea el script, revisa la política de ejecución de forma limitada; no desactives seguridad global.

Resultado esperado: La ruta apunta dentro de .venv.

Antes de continuar: No continúes si apunta al Python global.

Resultado esperado: La instalación termina con Successfully installed o indica que ya existe.

Antes de continuar: No uses sudo pip install.

Resultado esperado: requirements.txt contiene las dependencias del entorno.

Antes de continuar: No copies toda tu instalación global; confirma primero que .venv está activo.

Resultado esperado: sys.executable apunta a .venv.

Antes de continuar: Una terminal antigua puede seguir usando otro intérprete.

Resultado esperado: Primero aparece un error controlado; después el programa muestra un mensaje claro.

Antes de continuar: No borres el stack trace antes de identificar archivo, línea y tipo de error.

Resultado esperado: Puedes reconstruir el entorno sin perder tu código.

Antes de continuar: Nunca elimines la carpeta del proyecto cuando solo necesitas recrear .venv.

⌨️ Comandos y archivos

Escribe los comandos uno por uno. Presiona Enter después de cada línea.

macOS

python3 -m venv .venv
source .venv/bin/activate
which python
python -m pip install --upgrade pip
python -m pip install rich
python -m pip freeze > requirements.txt

Windows · PowerShell

python -m venv .venv
.venv\Scripts\Activate.ps1
where.exe python
python -m pip install --upgrade pip
python -m pip install rich
python -m pip freeze > requirements.txt

debug_lab.py

def average(values):
    if not values:
        raise ValueError("Agrega al menos un número")
    return sum(values) / len(values)

print(average([80, 90, 100]))

Comprobación final: El intérprete está dentro de .venv, rich está instalado, requirements.txt existe y puedes explicar un stack trace básico.

🛠️ Solución de problemas

Lo que ves	Qué hacer
No module named venv	La instalación de Python está incompleta o la distribución del sistema no incluye venv. Revisa la instalación oficial.
Activate.ps1 cannot be loaded	Consulta Get-ExecutionPolicy -List. Aplica únicamente una opción limitada al usuario si es necesaria y comprende el cambio.
pip instala fuera de .venv	Comprueba sys.executable y la ruta de python antes de instalar.
No module named rich	Activa .venv y ejecuta python -m pip install -r requirements.txt.
ZeroDivisionError	La lista estaba vacía. Añade una validación antes de dividir.

🤖 Usa Cursor como tutor

Estoy siguiendo la lección 00-08 para una persona principiante.
Explica el siguiente paso sin ejecutar comandos por mí.
Indica qué debería ver y cómo comprobarlo.
No modifiques archivos ni configuración sin mi aprobación.

🏁 Desafíos

El desafío esencial es parte de la lección. Los otros dos permiten practicar más.

🟢 Esencial

Crea .venv, instala rich y genera requirements.txt.

🟡 Práctica

Crea environment_report.py con versión, ejecutable y paquetes instalados.

🔴 Desafío

Elimina .venv, recréalo y restaura dependencias solo con requirements.txt.

✅ Checklist mejorado

Tu progreso se guarda en este navegador. Una lección se completa cuando todas las comprobaciones están marcadas.