shelf

# Shelf Shelf es un catálogo de biblioteca doméstica autoalojado que combina escaneo de códigos de barras, ingesta de fotos con IA, búsqueda automática de metadatos y gestión integral de colecciones en un único contenedor Docker. Se ejecuta completamente en tu red con una base de datos SQLite, por lo que tus datos nunca salen de tu hogar. ## Características principales ### Escaneo y metadatos - **Escaneo de códigos de barras con cámara** en dispositivos móviles (iOS y Android) para ISBN y UPC, además de compatibilidad con escáneres USB/Bluetooth - **8 modos de escaneo**: Añadir, Lista de deseos, Prestar, Devolver, Mover, Inventario, Consultar y Valoración rápida - **Ingesta de fotos**: toma una foto de una estantería y un modelo de visión lee los lomos, detectando libros, DVD y videojuegos. Funciona con la API de Anthropic, endpoints compatibles con OpenAI o modelos Ollama totalmente locales - **Búsqueda por título** en Open Library (libros), TMDb (películas) e IGDB (videojuegos) - **Búsqueda en cascada de metadatos** desde Open Library, Hardcover, Google Books y bibliografías nacionales (DNB alemana, SBN italiana) - **Pipeline de portadas** con una cola de revisión para elementos sin portada - **Detección de tipo de medio**: los códigos de barras determinan el tipo de medio (ISBN = libro, UPC de juego = videojuego, etc.) - **Catalogación de música** por edición (no solo por título) mediante MusicBrainz, con listas de pistas y detalles de prensaje - **Publicaciones periódicas** como modelo de publicación más número - **Manga** como tipo de medio propio ### Gestión de colecciones - **Multiusuario** con roles de administrador/visor - **Ubicaciones** con organización anidada (habitación → estantería → balda) - **Seguimiento de copias físicas** con ubicaciones individuales, condiciones y procedencia - **Sistema de préstamos** con recordatorios de préstamo (ntfy o webhook) - **Seguimiento de series** con detección de huecos e integración con la lista de deseos - **Etiquetas personalizadas** con aplicación masiva y gestión de administrador - **Seguimiento de lectura** (por leer, leyendo, leído) - **Panel de estadísticas** con libros leídos por año, crecimiento de la colección y gráficos de valor a lo largo del tiempo - **Resúmenes**: imágenes compartibles de resúmenes de lectura mensuales/anuales - **Informe de valoración** mediante ISBNdb para documentación de seguros - **Papelera** con funcionalidad de restauración y ventana de retención - **Importación/exportación CSV** y archivo portátil (zip con portadas) - **Migración** desde Goodreads, StoryGraph, LibraryThing y Libib ### Detalles técnicos - **Stack**: FastAPI + SQLite + HTMX - **Despliegue**: contenedor Docker único con certificados TLS generados automáticamente - **PWA**: modo librería sin conexión - **Configuración**: perfiles de características (Mínimo, Estándar, Todo) con conmutadores granulares - **Seguridad**: credenciales de API cifradas, sesiones JWT, claves de cifrado separadas ## Inicio rápido ```bash docker compose up -d ``` Abre `https://localhost:18888` y crea tu cuenta de administrador mediante el asistente de configuración. ## Documentación La documentación completa está disponible en el directorio `docs/`, y abarca instalación, configuración, guías de usuario para cada función, preguntas frecuentes, solución de problemas y arquitectura. ## Licencia AGPL-3.0