Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

scrinium

Scrinium es una biblioteca de documentos PDF autoalojada con OCR local. Reemplaza Paperless-ngx con un diseño más robusto y seguro, eliminando sus puntos débiles conocidos.

Ficha actualizada 22 sept 2026, 23:23 · upstream 22 sept 2026, 23:02 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es scrinium

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Scrinium es una aplicación web autoalojada que permite almacenar, organizar y visualizar documentos en formato PDF mediante OCR (reconocimiento óptico de caracteres) local. Su arquitectura está diseñada para ser segura, escalable y fácil de mantener. La plataforma utiliza PostgreSQL como base de datos principal, con un sistema de caché en memoria para mejorar la velocidad de búsqueda y consulta. El OCR se ejecuta directamente dentro del contenedor, utilizando Tesseract como motor por defecto o Apple Vision a través de un lado-carrito (sidecar) en macOS para obtener resultados significativamente superiores.

La aplicación permite organizar documentos mediante etiquetas jerárquicas con materialización automática de ancestros, correspondientes, tipos de documento y campos personalizados. Además, extrae fechas de texto, genera vistas personalizadas transparentes y soporta clasificación sin necesidad de modelos entrenados. La búsqueda se realiza en PostgreSQL a nivel completo de texto, permitiendo saltos directos al documento encontrado dentro del visualizador.

Un sistema de gestión de permisos permite la creación de cuentas con roles diferenciados: el administrador (Owner) tiene acceso total y puede realizar acciones irreversibles como eliminar documentos permanentemente o borrar etiquetas, mientras que los miembros pueden realizar todas las operaciones permitidas por su rol. La arquitectura está diseñada para ser compartida entre múltiples usuarios en una misma instalación, lo cual es ideal para familias o equipos pequeños.

La plataforma soporta exportación completa de la biblioteca original junto con archivos archivados y un manifiesto de metadatos, además de importar documentos desde Paperless-ngx manteniendo intactos los metadatos. El sistema permite pausar y resumar el procesamiento del flujo de trabajo sin perder progreso, y ofrece una experiencia de usuario fluida con interfaces web modernas y aplicaciones nativas para iOS.

CASOS DE USO
  • Organizar documentos PDF en un entorno doméstico o familiar
  • Procesar documentos escaneados con OCR local sin depender de servicios externos
  • Gestionar documentos legales o financieros con seguridad y control de acceso
  • Crear una biblioteca personal que funcione como alternativa a Paperless-ngx
  • Almacenar documentos en la nube con un backend propio y bajo costo
  • Procesar documentos antiguos sin necesidad de migración previa
PUNTOS DESTACADOS
  • OCR local mediante Tesseract o Apple Vision, eliminando dependencias externas
  • Búsqueda full-text en PostgreSQL con indexado eficiente
  • Sistema de permisos basado en roles (Owner vs Member) sin permisos por documento
  • Exportación completa y importación desde Paperless-ngx manteniendo metadatos
  • Soporte para múltiples fuentes OCR: Tesseract, Apple Vision y captura con iOS app
  • Diseño modular con backend independiente del frontend mediante FastAPI
PRECAUCIONES
  • No ofrece permisos granulares por documento (todos los miembros ven todo)
  • El OCR puede fallar en documentos complejos o con mala calidad de imagen
  • La base de datos PostgreSQL consume recursos significativos, especialmente con muchas páginas
  • No incluye un editor de texto nativo ni herramientas de edición avanzada
  • La interfaz web es moderna pero no está optimizada para dispositivos móviles
  • El OCR en Tesseract puede ser lento en entornos con GPU dedicada
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO20 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Para desplegar Scrinium, se recomienda usar Docker Compose. Se ejecuta primero el contenedor de PostgreSQL y luego los servicios API y worker. El frontend se despliega mediante Vite con un proxy al puerto 5173 que redirige a /api. Para producción, se puede migrar a Kubernetes o una infraestructura cloud como AWS EKS. Todas las variables de entorno deben configurarse explícitamente en el archivo docker-compose.yml para evitar problemas de configuración. Se recomienda usar un plano de red con la base de datos aislada del frontend y worker. El despliegue es completamente autocontenido sin dependencias externas, lo que lo hace ideal para entornos locales o privados.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
ReactFastAPIPython
SERVICIOS
PostgreSQL
BASES DE DATOS
PostgreSQL
PUERTOS
5173993
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.