Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

beepub

BeePub es una biblioteca de libros electrónicos auto-alojada para colecciones EPUB (con conversión automática de TXT a EPUB). Funciona como alternativa moderna a calibre-web, ofreciendo gestión de biblioteca, lector web con progreso, resaltados y notas, app nativa iOS vía Capacitor, catálogo OPDS pa

Ficha actualizada 28 sept 2026, 17:24 · upstream 28 sept 2026, 17:10 · release v0.13.0

00

Qué es beepub

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

BeePub es una plataforma auto-alojada de gestión de libros electrónicos y lectura web para colecciones EPUB. Combina administración de biblioteca, lector web con seguimiento de progreso, resaltados, notas, índice de contenidos y controles móviles amigables, junto con app nativa iOS construida con Capacitor. Incluye catálogo OPDS para navegadores en e-readers como KOReader, Readest y Foliate, más sincronización de progreso compatible con KOReader.

El sistema soporta características opcionales asistidas por IA: etiquetado automático, resúmenes, chat de acompañante, ilustraciones generadas, búsqueda semántica y recomendaciones de libros similares. Incluye servidor MCP (Model Context Protocol) para que asistentes AI busquen la biblioteca completa, recuperen pasajes de texto completo, recapitulen lecturas hasta el punto donde se dejó y trabajen con resaltados y notas.

La arquitectura utiliza Next.js en frontend, PostgreSQL con pgvector para búsqueda semántica y Redis como caché. Soporta despliegue único con docker-compose multi-arch (amd64/arm64) desde imágenes pre-construidas en GHCR, sin necesidad de construir localmente. Incluye migración automática desde versiones anteriores que usaban volúmenes separados.

CASOS DE USO
  • Gestión centralizada de biblioteca EPUB con lectura web y móvil sin instalar Calibre
  • Sincronización de progreso de lectura entre e-readers KOReader y plataforma web
  • Búsqueda semántica de pasajes en textos completos mediante MCP para asistentes AI
  • Catálogo OPDS público para descarga directa desde lectores electrónicos
  • Alternativa moderna a calibre-web con soporte nativo iOS vía Capacitor
PUNTOS DESTACADOS
  • Despliegue único con docker-compose multi-arch sin construcción local requerida
  • Conversión automática de TXT a EPUB al subir archivos
  • Servidor MCP integrado para búsqueda semántica y resumen de lecturas en asistentes AI
  • Sincronización bidireccional KOReader con checksum binario exacto
  • Búsqueda semántica nativa con PostgreSQL+pgvector
  • Migración automática desde versiones anteriores con volúmenes separados
PRECAUCIONES
  • Requiere red interna para acceso a base de datos PostgreSQL (no accesible externamente)
  • Dependencia de imágenes pre-construidas en GHCR o construcción manual local
  • Funcionalidades AI opcionales requieren configuración de API keys externas
  • Migración desde versiones <0.13 requiere espacio temporal duplicado durante transferencia
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

BeePub home screenBeePub reader screenBeePub
01

Perfil de infraestructura

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

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

Despliegue detectado

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

Listo para automatizar

Desplegar con docker-compose multi-arch (amd64/arm64) desde GHCR sin construcción local. Configurar POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD y SECRET_KEY en .env. Para reverse proxy: mantener BACKEND_URL apuntando al servicio interno y configurar ORIGIN para frontend SvelteKit. Backup obligatorio de volúmenes data y postgres_data antes de upgrades.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

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

FRAMEWORKS
Next.js
SERVICIOS
PostgreSQLRedis
BASES DE DATOS
PostgreSQLRedis
PUERTOS
80
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.