lecture-note-app
Plataforma auto-alojada para grabar clases y generar notas con IA. Usa Whisper para transcripción y modelos LLM locales o API externas. Arquitectura React/FastAPI en Docker Compose.
Ficha actualizada 23 sept 2026, 23:47 · upstream 23 sept 2026, 23:44 · release v1.1.0
Qué es lecture-note-app
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
La aplicación permite grabar conferencias desde el navegador, enviando fragmentos de audio vía WebSocket al backend FastAPI. Este procesa la transcripción en tiempo real con faster-whisper y genera notas estructuradas mediante modelos de lenguaje (Ollama por defecto o proveedores externos como OpenAI/Claude). El frontend React se comunica con el backend para mostrar transcripciones y chat interactivo.
El sistema utiliza PostgreSQL para almacenar sesiones, usuarios y metadatos, mientras que MinIO gestiona los fragmentos de audio y archivos adjuntos. Soporta gestión multiusuario con roles, autenticación por email y cuotas de almacenamiento personal. La arquitectura permite cambiar dinámicamente entre modelos locales y APIs en la nube según configuración.
El despliegue se realiza mediante Docker Compose, incluyendo servicios para base de datos, almacenamiento y la aplicación. Para acceso público seguro sin dominio propio, utiliza Tailscale con Funnel. Incluye sistema de backups encriptados nocturnos y monitorización de salud vía endpoint /health.
- Grabar clases o conferencias en vivo desde el navegador con transcripción automática
- Generar notas estructuradas automáticamente cada minuto durante la grabación
- Realizar preguntas sobre el contenido mediante chat con IA tras finalizar la clase
- Exportar notas y audio a formatos como PDF, Markdown, Word o MP3
- Auto-alojar la plataforma para mantener los datos privados en infraestructura propia
- Transcripción local con faster-whisper optimizada para CPU/GPU
- Proveedores de IA pluggables (Ollama, Claude, Gemini, OpenAI) sin vendor lock-in
- Arquitectura Docker Compose completa con servicios Postgres y MinIO integrados
- Gestión de usuarios con roles, confirmación por email y cuotas de almacenamiento
- Backups encriptados diarios con drills de restauración automatizados
- Exportación multi-formato para compatibilidad con herramientas externas
- Requiere Tailscale para habilitar URL pública HTTPS sin dominio propio o proxy inverso
- Alta demanda de recursos (CPU/RAM) para correr Whisper localmente en tiempo real
- Complejidad de despliegue HIGH, no incluye Dockerfile nativo sino build manual
- Dependencia de GPU recomendada para rendimiento óptimo en transcripción
- Requiere configuración inicial de modelos LLM y secretos en archivo .env
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Usar deploy/start.sh con Docker Compose. Mínimo 8GB RAM disponibles. Configurar Tailscale para acceso HTTPS seguro. Verificar modelos Ollama (llama3, llava) antes de iniciar. Monitorizar con GET /health. Editar deploy/.env para claves secretas y credenciales.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.