🧠 BrainCourse V2

Plataforma educativa inteligente con IA para generación automática de cursos personalizados

📋 Descripción

BrainCourse V2 es una aplicación de escritorio avanzada que utiliza Inteligencia Artificial (Google Gemini API) para generar cursos educativos personalizados de manera automática. Diseñada con CustomTkinter, ofrece una interfaz moderna y funcionalidades completas para estudiantes y profesores.

✨ Características Principales

Para Estudiantes

• 🎓 Generación Automática de Cursos - Crea cursos completos con IA
• 📝 Ejercicios Interactivos - Práctica con retroalimentación instantánea
• 🏆 Sistema de Logros - Gamificación del aprendizaje
• 🎤 Asistente de Voz - Interacción por voz con el sistema
• 📊 Seguimiento de Progreso - Visualiza tu avance
• 💾 Gestión de Usuarios - Perfiles personalizados

Para Profesores

• 👨‍🏫 Vista de Profesor - Panel de control dedicado
• 📈 Análisis de Estudiantes - Estadísticas detalladas
• ✅ Control de Calidad - Revisión de contenido generado
• 📚 Gestión de Cursos - Administración completa

🚀 Instalación

Requisitos Previos

• Python 3.11 o superior
• API Key de Google Gemini
• Sistema Operativo: Windows, macOS o Linux

Instalación Rápida

# Clonar repositorio
git clone https://github.com/jjho05/BrainCourse.git
cd BrainCourse

# Instalar dependencias
pip install -r requirements.txt

# Configurar API Key
echo "TU_API_KEY_AQUI" > api_key.txt

# Ejecutar aplicación
python main.py

📦 Dependencias

customtkinter==5.2.0
google-generativeai==0.3.0
Pillow==10.1.0
pyttsx3==2.90
SpeechRecognition==3.10.0

🏗️ Estructura del Proyecto

BrainCourse-V2/
├── main.py                    # Aplicación principal
├── curso_generator.py         # Generador de cursos con IA
├── ejercicios.py             # Sistema de ejercicios
├── gestion_usuarios.py       # Gestión de perfiles
├── logros.py                 # Sistema de logros
├── teacher_view.py           # Vista de profesor
├── voice_assistant.py        # Asistente de voz
├── rich_text_widget.py       # Widget de texto enriquecido
├── quality_control.py        # Control de calidad
├── api_key.txt               # API Key (no incluida)
└── correciones.json          # Datos de correcciones

💻 Uso

Inicio de Sesión

1. Ejecuta python main.py
2. Ingresa tu nombre de usuario
3. Selecciona tu rol (Estudiante/Profesor)

Generar un Curso

1. Click en "Generar Curso"
2. Ingresa el tema del curso
3. Espera mientras la IA genera el contenido
4. Navega por las lecciones generadas

Realizar Ejercicios

1. Selecciona un curso
2. Click en "Ejercicios"
3. Responde las preguntas
4. Recibe retroalimentación instantánea

Vista de Profesor

1. Inicia sesión como profesor
2. Accede al panel de control
3. Revisa estadísticas de estudiantes
4. Gestiona cursos y contenido

🎯 Funcionalidades Detalladas

1. Generación de Cursos con IA

Características:

• Generación automática de lecciones
• Contenido estructurado y coherente
• Adaptado al nivel del estudiante
• Ejemplos prácticos incluidos

2. Sistema de Ejercicios

Tipos de ejercicios:

• Opción múltiple
• Verdadero/Falso
• Respuesta corta
• Código práctico

3. Sistema de Logros

Logros disponibles:

• 🎓 Primer Curso Completado
• 🔥 Racha de 7 días
• 💯 100% en Ejercicios
• 🏆 Maestro del Tema

4. Asistente de Voz

Comandos de voz:

• "Generar curso de [tema]"
• "Mostrar mi progreso"
• "Abrir ejercicios"
• "Leer lección actual"

🎨 Interfaz de Usuario

Tema Oscuro Moderno

# Colores personalizados
COLOR_PRIMARIO = "#1f538d"
COLOR_SECUNDARIO = "#14375e"
COLOR_ACENTO = "#00d4aa"

Componentes

• Sidebar - Navegación principal
• Content Frame - Área de contenido dinámico
• Rich Text Widget - Visualización de lecciones
• Progress Bar - Indicador de progreso
• Cards - Tarjetas de cursos y logros

🔐 Configuración de API

Obtener API Key de Google Gemini

1. Ve a Google AI Studio
2. Crea un nuevo proyecto
3. Genera una API Key
4. Guárdala en api_key.txt

echo "tu-api-key-aqui" > api_key.txt

📈 Roadmap

• Integración con más modelos de IA
• Exportación de cursos a PDF
• Modo colaborativo
• App móvil (React Native)
• Integración con LMS
• Soporte multiidioma

🐛 Solución de Problemas

Error: API Key Inválida

# Verifica que api_key.txt contenga una key válida
cat api_key.txt

Error: Módulo no encontrado

# Reinstala dependencias
pip install -r requirements.txt --force-reinstall

🤝 Contribuir

Las contribuciones son bienvenidas. Para cambios importantes:

1. Fork el proyecto
2. Crea una rama (git checkout -b feature/mejora)
3. Commit cambios (git commit -m 'feat: añadir mejora')
4. Push a la rama (git push origin feature/mejora)
5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT.

👥 Autores

• Jesús Javier Hernández Olvera - Desarrollo principal - @jjho05
• Jose Antonio Betancourt Hernandez - Colaborador
• Angel Gonzalez Pancardo - Colaborador
• Jesús Antonio Flores Gonzalez - Colaborador

🙏 Agradecimientos

• Google por la API de Gemini
• CustomTkinter por el framework de UI
• Comunidad de Python
• Usuarios beta testers

📞 Contacto

• GitHub: @jjho05
• Email: jjho.reivaj05@gmail.com / hernandez.jesusjavier.20.0770@gmail.com

---

⭐ Si este proyecto te fue útil, considera darle una estrella en GitHub

Hecho con ❤️ y ☕ para revolucionar la educación

BrainCourse V2 - Educación potenciada por IA 🚀