Skip to content

02-step.md

Latest commit

 

History

History
77 lines (53 loc) · 3.34 KB

02-step.md

File metadata and controls

77 lines (53 loc) · 3.34 KB

Paso 2: Verificar tu entorno

Resumen: En este paso, verificarás que tu entorno esté configurado correctamente ejecutando un script de prueba. El script verifica la estructura de tu aplicación, valida tu token de GitHub, prueba la conectividad con el servicio de IA y confirma que todas las dependencias estén instaladas.

El script test_setup.py es una herramienta de diagnóstico que realiza una serie de comprobaciones para asegurar que tu entorno esté configurado correctamente. Específicamente:

  • Verifica la estructura de la aplicación: Confirma que todos los archivos necesarios estén presentes (por ejemplo, app/main.py, app/services/github_client.py).
  • Valida el token de GitHub: Busca la variable GITHUB_TOKEN en tu archivo .env y asegura que esté configurada.
  • Prueba la conectividad con el servicio de IA: Envía una solicitud de prueba al servicio de modelos de IA de GitHub usando tu token para verificar el acceso al servicio y los permisos.
  • Confirma las dependencias: Verifica que todas las bibliotecas de Python necesarias estén instaladas.

⌨️ Actividad: Prueba Tu Configuración

  1. Antes de ejecutar la prueba, necesitas implementar la función check_dependencies para verificar que todos los paquetes requeridos estén instalados. Abre el archivo test_setup.py, luego en el panel Copilot Chat y selecciona el modo Edit.

    📸 Mostrar captura de pantalla Captura de pantalla de la pestaña Ports

  2. Pide a Copilot que actualice la función:

Static Badge

Actualiza la función check_dependencies para leer los paquetes desde requirements.txt e intentar importar cada uno. Imprime "✅ Dependencias importadas correctamente" en la lista final de resultados cuando todas las dependencias estén instaladas. Si falta alguna, lista los paquetes faltantes.

  1. Revisa la implementación para asegurar que verifica correctamente todas las dependencias del archivo requirements.txt.

  2. Abre tu terminal y verifica tu configuración ejecutando:

python test_setup.py

Resultado esperado:

✅ Estructura de la aplicación verificada
✅ GITHUB_TOKEN encontrado
✅ Modelos de GitHub funcionando - Respuesta: OK  
✅ Dependencias importadas correctamente
🎉 ¡Configuración completa! Todo listo para ejecutar la aplicación.
🤷 ¿Tienes problemas?

  1. Problemas con el token de GitHub:

    • Asegúrate de que está copiado correctamente (sin espacios adicionales)
    • Confirma que el alcance read:user está habilitado
    • Usa un token clásico, no de grano fino

  2. Errores de dependencia:

# Actualiza pip
python -m pip install --upgrade pip

# Reinstala las dependencias
pip install -r requirements.txt

  1. Python no encontrado localmente:

    • Windows: Instala desde python.org
    • Asegúrate de que la versión de Python sea 3.9 o superior
← Introducción a la Aplicación StudyPlan y Configuración del Entorno Siguiente: Backend e Integración con IA →