📚 Slides 2 Notes

Genera apuntes a partir de tus presentaciones PDF usando modelos de IA generativa.

Generate clean study notes from PDF slides using Generative AI.

---

📑 Índice

1. Descripción
2. Instalación rápida
3. Uso básico
4. Ejemplos avanzados
5. Arquitectura
6. API de comandos
7. Contribuir
8. Licencia
9. Contacto
10. English Quick Guide

Descripción

Slides 2 Notes automatiza la creación de apuntes a partir de presentaciones en PDF. Convierte cada diapositiva en una imagen, la interpreta con modelos como GPT-4o o Gemini 1.5 y genera un documento en Markdown editable. Posteriormente permite refinar los apuntes, generar versiones extendidas e incluso crear audio a partir de texto.

Instalación rápida

Consulta la guía completa en docs/INSTALL.md. Resumen:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r extra/requirements.txt
# o bien
pip install -e .

Configura tus claves en un archivo .env:

OPENAI_API_KEY="tu_clave"
GOOGLE_API_KEY="tu_clave"

Uso básico

Convierte todas las presentaciones del directorio PDFs en notas Markdown:

python Slides2Notes.py --folder_pdfs extra/PDFs --folder_save extra/MD --md2docx

Refina los apuntes generados y crea versiones temáticas:

python Notes2Notes.py --debug --limit 1 --md2docx

Convierte un apunte en audio:

python Note2Audio.py --file extra/MD/proyecto_salida_note_final.md

Ejemplos avanzados

• Procesar un único PDF con DPI personalizado y salida a PDF:

python Slides2Notes.py -l 1 --dpi 300 --md2pdf

• Ejecutar la tubería completa:

python AllInOne.py

Arquitectura

Ver la descripción detallada en docs/ARCHITECTURE.md. Resumen:

PDFs → Slides2Notes → Markdown
Markdown → Notes2Notes → Apuntes extendidos
Apuntes → Note2Audio → MP3

Los modelos de IA se aíslan en models/ para facilitar la integración con diferentes proveedores.

API de comandos

Se exponen interfaces de línea de comandos para cada módulo principal. Consulta docs/API.md para todos los parámetros disponibles.

Contribuir

Las guías de estilo, issues y PRs se detallan en docs/CONTRIBUTING.md.

Licencia

Este proyecto está disponible bajo la licencia MIT.

Contacto

¿Dudas o sugerencias? Abre un issue o escríbenos a opensource@example.com.

English Quick Guide

Slides 2 Notes automatically turns PDF slides into study notes using GPT-4o or Gemini. Install with pip install -e ., set your API keys in a .env file and run the CLI tools:

• Slides2Notes.py converts slides to Markdown.
• Notes2Notes.py expands notes.
• Note2Audio.py generates MP3 audio. Contributions and issues are welcome!