KuroTutor
KuroTutor es un bot de IA para tutoría privada en QQ que ofrece resolución de problemas visuales, corrección de tareas y repaso personalizado. Incluye panel web de gestión, backup encriptado y soporte Docker para despliegue autoalojado sin GPU.
Ficha actualizada 25 sept 2026, 11:55 · upstream 25 sept 2026, 11:44 · release v0.8.0
Qué es KuroTutor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
KuroTutor es una plataforma de inteligencia artificial diseñada para funcionar como un tutor particular dentro de la aplicación QQ. Permite a los estudiantes subir fotografías de ejercicios o tareas completas para recibir corrección automática, explicaciones paso a paso y organización en un cuaderno de errores basado en la curva del olvido. La herramienta integra capacidades multimodales para interpretar imágenes matemáticas, generar contenido educativo personalizado y gestionar sesiones de estudio programadas.
La arquitectura se basa en Python 3.11+ con FastAPI y Node.js, ofreciendo una interfaz web para supervisar el progreso académico, configurar modelos de lenguaje compatibles (como GLM o DeepSeek) y administrar datos sensibles. El sistema soporta despliegue mediante Docker con soporte nativo para amd64 y arm64, permitiendo una instalación sencilla en servidores propios sin necesidad de hardware especializado como GPUs, aunque requiere recursos mínimos de 4 núcleos CPU y 8 GB de RAM.
- Resolución de problemas académicos mediante captura de pantalla con explicaciones pedagógicas guiadas.
- Gestión automatizada de tareas escolares con corrección por lotes y clasificación de errores.
- Generación dinámica de ejercicios adaptados al nivel del estudiante y su progreso en la plataforma.
- Organización de sesiones de estudio programadas con recordatorios automáticos y resúmenes post-clase.
- Soporte nativo para despliegue Docker con imágenes optimizadas para amd64 y arm64.
- Interfaz web intuitiva para gestión de estudiantes, visualización de métricas y edición de configuraciones en tiempo real.
- Integración con múltiples modelos de lenguaje compatibles vía API (OpenAI compatible) sin depender exclusivamente de OpenAI.
- Sistema de backup encriptado AES que permite restaurar versiones anteriores de datos desde un repositorio externo.
- Dependencia crítica de claves API externas (modelos de lenguaje, búsqueda) que deben gestionarse manualmente en el archivo de configuración local.
- Requiere instalación manual de Python 3.11+ o uso de scripts de setup.sh para entornos sin Docker preconfigurados.
- Funcionalidad de backup encriptado a Gitee es opcional y requiere configuración adicional de repositorios externos.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado usar el script setup.sh para despliegue rápido con Docker. Montar volúmenes persistentes para datos y configuración. Configurar variables de entorno en .env para puertos personalizados (KURO_PANEL_PORT). Asegurar que el servidor tenga al menos 4 núcleos CPU y 8 GB RAM. No exponer credenciales en repositorios públicos; usar tokens webui.token para acceso seguro al panel.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.