BookOasis_stable
Servidor web ligero en Python para streaming directo de libros y cómics (ZIP/CBZ/EPUB/PDF) sin descarga previa. Soporta bases de datos SQLite/MariaDB, caché Redis opcional y OPDS móvil.
Ficha actualizada 22 sept 2026, 14:57 · upstream 22 sept 2026, 13:57 · release v2.7.7
Qué es BookOasis_stable
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
BookOasis es una alternativa ligera a soluciones como Kavita o Komga, diseñada para streaming eficiente de archivos comprimidos directamente desde almacenamiento remoto. Su arquitectura minimiza dependencias externas utilizando Python estándar y Flask, evitando ORM pesados para reducir la huella de memoria.
La aplicación implementa un sistema de escaneo inteligente que lee solo los bytes necesarios de archivos ZIP/CBZ sin descomprimirlos previamente, lo que reduce drásticamente el uso de CPU y disco. Incluye soporte nativo para bases de datos SQLite con caché en Redis para evitar cuellos de botella en I/O, además de una arquitectura híbrida que permite migración transparente a MariaDB para bibliotecas masivas.
El frontend utiliza Vanilla JS sin frameworks pesados, implementando carga diferida (lazy loading) y pre-carga de páginas para una experiencia de lectura fluida. Soporta autenticación básica, integración con proxies SSO (Proxy Header Auth), OPDS para lectores móviles y gestión avanzada de metadatos mediante plugins.
- Streaming directo de cómics ZIP/CBZ desde NAS sin descargar archivos completos
- Gestión de bibliotecas de libros EPUB/PDF con extracción de metadatos en tiempo real
- Lectura móvil vía OPDS integrado con lectores como Moon+ Reader o Apple Books
- Migración de colecciones desde Kavita/Komga manteniendo historial de lectura
- Streaming sin descompresión previa de archivos ZIP/CBZ/EPUB/PDF
- Arquitectura minimalista con Flask y Python estándar (cero dependencias externas)
- Soporte oficial para MariaDB en bibliotecas superiores a 100.000 volúmenes
- Caché híbrida SQLite-Redis que previene corrupción de datos durante escaneo
- Integración nativa con OPDS para sincronización móvil sin app dedicada
- Requiere configuración manual de rutas en docker-compose.override.yml
- La autenticación Proxy Header Auth solo es segura en redes cerradas con Nginx/Reverse Proxy
- No incluye interfaz gráfica para edición avanzada de metadatos sin plugins
- Dependencia de Python 3.x (requiere entorno virtual o contenedor)
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 usando docker-compose.yml oficial. Copiar docker-compose.override.example.yml y configurar rutas de volúmenes antes de ejecutar 'docker compose up -d'. Asegurar puertos 5930 (app), 6379 (Redis) y 3306/8080 (MariaDB si aplica). Para producción, habilitar HTTPS y configurar PROXY_HEADER_TRUSTED_IPS en .env. Usar docker-compose.mariadb.ghcr.yml para bibliotecas masivas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.