ex-libris
Ex Libris es un catálogo auto-alojado para gestionar colecciones de libros con escaneo de códigos de barras desde el navegador móvil. Utiliza Next.js y FastAPI en un contenedor Docker, ofreciendo gestión de ediciones, vista pública readonly y backups automáticos sin login nativo, requiriendo proxy s
Ficha actualizada 26 sept 2026, 18:58 · upstream 26 sept 2026, 17:34 · release v1.0.1
Qué es ex-libris
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Ex Libris es una aplicación auto-alojada diseñada para catalogar colecciones de libros personales mediante escaneo de códigos de barras desde el navegador móvil. Construida con Next.js y FastAPI, gestiona ediciones distintas, portadas y estadísticas en un único contenedor Docker que consume recursos moderados. La arquitectura separa la vista privada (gestión) de una vista pública readonly, permitiendo compartir la colección sin riesgo de modificación.
La seguridad se basa en el uso de HTTPS para habilitar la cámara del móvil y proxies como Cloudflare Tunnel o Tailscale, ya que no incluye autenticación nativa. Los datos persisten en SQLite con backups diarios automáticos y exportación CSV. Es ideal para entornos domésticos o servidores ligeros donde se desea un inventario digital sin dependencias complejas.
- Inventario personal de libros con escaneo ISBN desde navegador móvil
- Verificación de posesión de ediciones específicas en librerías físicas
- Vista pública readonly compartible sin riesgo de modificación
- Gestión de estadísticas como longitud de estantería o autores favoritos
- Importación masiva mediante archivos CSV para migración de datos
- Organización por series, géneros y ubicación física en la estantería
- Escaneo de cámara nativo sin instalar aplicaciones móviles adicionales
- Separación estricta entre endpoints de escritura (8080) y lectura pública (8081)
- Bajo consumo de memoria (~50-70MB idle) gracias a SQLite y contenedor único
- Backups automáticos diarios con retención de 30 días en carpeta local
- Soporte para múltiples ediciones del mismo título como copias independientes
- Requiere proxy HTTPS (Cloudflare/Tailscale) para escaneo móvil desde fuera de localhost
- Ausencia de sistema de login nativo en la interfaz principal de gestión
- Dependencia de APIs externas (Open Library, Google Books) para metadatos y portadas
- No soporta indexación por motores de búsqueda en la vista pública compartida
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.
Desplegar con Docker Compose montando el volumen ./data. Configurar EXLIBRIS_PUBLIC=on para la vista pública. Para acceso móvil seguro, usar Cloudflare Tunnel o Tailscale para obtener HTTPS sin abrir puertos en el router. Asegurar permisos de usuario PUID/PGID en el directorio de datos.
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.