Tutorials5 min read

Primeros pasos con Scholaris: Guía rápida

Aprende a configurar Scholaris, subir tu primer documento y comenzar a buscar en tu biblioteca de investigación con búsqueda semántica impulsada por IA.

By Scholaris Team

¿Qué es Scholaris?

Scholaris es un asistente de investigación impulsado por IA que transforma la forma en que interactúas con artículos académicos, informes y otros documentos. En lugar de recorrer manualmente decenas de PDFs para encontrar un pasaje o una figura concreta, Scholaris te permite hacer preguntas en lenguaje natural y obtener respuestas precisas extraídas directamente de tu biblioteca personal.

En su núcleo, Scholaris convierte tus documentos a un formato semántico enriquecido llamado SPDF, que permite una comprensión profunda de cada párrafo, figura y tabla de tus archivos. Una vez convertidos, tus documentos se vuelven completamente buscables utilizando modelos de IA de última generación que entienden el significado en lugar de limitarse a coincidir palabras clave.

Todo funciona 100% en local en tu propio hardware. Tus documentos nunca abandonan tu máquina, lo que significa que tu investigación permanece privada y segura por defecto. No hay suscripciones en la nube, no se comparten datos y no hay límites de uso más allá de la capacidad de tu propio equipo.

Instalación y configuración de Scholaris

Empezar solo requiere unos pocos pasos. Scholaris consta de un frontend web y un backend local que se encarga de la inferencia con IA.

Requisitos del sistema

Antes de comenzar, asegúrate de que tu sistema cumple estos requisitos mínimos:

  • Sistema operativo: Linux, macOS o Windows (se recomienda WSL2)
  • RAM: 16 GB o más
  • Almacenamiento: Al menos 10 GB libres para modelos y documentos
  • GPU (opcional pero recomendada): Una GPU NVIDIA con 6+ GB de VRAM acelera drásticamente el procesamiento de documentos

Si tienes una NVIDIA RTX 3060 o superior, puedes esperar que un PDF de 15 páginas se procese completamente en unos tres minutos. El modo solo CPU también funciona, pero los tiempos de procesamiento serán más largos.

Ejecutar la aplicación

Inicia el servidor backend y el frontend en terminales separadas:

# Terminal 1 - Iniciar el backend
cd backend
source .venv/bin/activate
uvicorn app.main:app --host 127.0.0.1 --port 8765 --reload

# Terminal 2 - Iniciar el frontend
cd frontend
npm run dev

Una vez que ambos servicios estén en marcha, abre tu navegador y ve a http://localhost:3000. Deberías ver el panel de control de Scholaris listo para usar.

Subir tu primer documento

Con Scholaris en marcha, añadir documentos a tu biblioteca es sencillo:

  1. Ve a la página de Documentos desde la barra lateral.
  2. Haz clic en el botón Subir y selecciona un PDF de tu sistema de archivos.
  3. Scholaris comenzará a convertir el PDF al formato SPDF. Puedes seguir el progreso en tiempo real a través del indicador de estado de conversión.
  4. Una vez completado el procesamiento, el documento aparece en tu biblioteca con texto completo, metadatos y embeddings listos para la búsqueda.

Scholaris extrae texto mediante modelos avanzados de OCR, por lo que incluso los PDFs escaneados y los documentos con muchas imágenes son completamente buscables tras la conversión. Los metadatos como título, autores y fecha de publicación se detectan automáticamente cuando están disponibles.

Buscar en tu biblioteca

Aquí es donde Scholaris realmente destaca. Una vez que tienes documentos en tu biblioteca, puedes buscar en todos ellos usando lenguaje natural.

Escribe una pregunta como "¿Cuáles son las principales limitaciones de las arquitecturas transformer?" en la barra de búsqueda. Scholaris usa búsqueda semántica para encontrar los pasajes más relevantes en todos los documentos de tu biblioteca, ordenados por significado en lugar de simple coincidencia de palabras clave.

La búsqueda admite varios modos potentes:

  • Búsqueda semántica: encuentra pasajes por significado, incluso si usan una redacción completamente diferente a tu consulta.
  • Búsqueda híbrida: combina coincidencia de palabras clave con comprensión semántica para obtener lo mejor de ambos mundos.
  • Búsqueda cross-modal: puede hacer coincidir consultas de texto con figuras, diagramas y fotogramas de vídeo en tipos de documentos compatibles.
  • Búsqueda inteligente: utiliza un LLM local para expandir tu consulta, detectar la intención y proporcionar extracción de respuestas directamente de los resultados.

Los resultados incluyen citas precisas con números de página, para que siempre puedas rastrear una respuesta hasta su fuente.

Uso de la función de citación automática

Scholaris incluye una herramienta de citación automática que te ayuda a generar citas correctamente formateadas para cualquier documento de tu biblioteca. Al ver los resultados de búsqueda o navegar por un documento, puedes generar citas en formatos comunes como APA, MLA, Chicago y BibTeX con un solo clic.

El autocitador extrae los metadatos directamente de la representación SPDF del documento, incluyendo nombres de autores, fechas de publicación, títulos de revistas y DOIs. También puedes exportar citas en bloque usando el endpoint de exportación BibTeX, lo cual es útil al elaborar la lista de referencias para un artículo o una tesis.

Próximos pasos

Ahora que tienes Scholaris en marcha, aquí tienes algunas cosas que probar:

  • Crea bibliotecas para organizar documentos por proyecto, curso o tema.
  • Explora la búsqueda cross-modal subiendo documentos con figuras y buscando contenido visual.
  • Lee sobre el formato SPDF para entender qué hace que la búsqueda de Scholaris sea tan potente: ¿Qué es SPDF?
  • Prueba diferentes modos de búsqueda para ver cuál funciona mejor para tu flujo de trabajo de investigación.

Scholaris está diseñado para crecer con tu investigación. Cuantos más documentos añadas, más potente se vuelve tu base de conocimiento personal, y como todo permanece en tu máquina, tus datos siguen siendo solo tuyos.