librarium-api
Backend Go (v1.25) para Librarium, tracker auto-alojado de colecciones físicas con PostgreSQL 16, River para colas y documentación OpenAPI. Alternativa AGPL 3.0 a servicios cloud.
Ficha actualizada 24 sept 2026, 1:17 · upstream 24 sept 2026, 1:14 · release v26.9.0
Qué es librarium-api
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Librarium-api es el servicio backend del ecosistema Librarium, diseñado para gestionar catálogos de libros, manga y cómics en entornos auto-alojados. Construido con Go 1.25 y PostgreSQL 16, ofrece una arquitectura robusta que incluye River para procesamiento asíncrono de tareas como escaneos e importes. El proyecto sigue un ciclo de vida activo con documentación OpenAPI generada automáticamente y soporte para migraciones automáticas en arranque.
El repositorio forma parte de una suite completa que incluye clientes web (React/TypeScript), móvil (iOS) y servidores MCP para integración con LLMs. La versión actual se encuentra en beta temprana, lo que implica cambios frecuentes y posibles inestabilidades en bordes específicos. Se recomienda leer las notas de lanzamiento antes de cada actualización.
El despliegue soporta múltiples entornos: Docker Compose para stacks completos, Helm con CloudNativePG o Kubernetes nativo. La licencia AGPL-3.0 garantiza código abierto pero exige que las modificaciones también sean públicas si se distribuye.
- Gestión de inventario físico de colecciones (libros, manga, cómics) sin dependencia de nube
- Integración con clientes web y móviles mediante API RESTful documentada en OpenAPI
- Automatización de tareas de fondo como escaneos o importes usando River queue
- Sincronización entre múltiples instancias de servidor para colecciones distribuidas
- Arquitectura Go moderna con soporte nativo para multi-arch y despliegues eficientes
- Base de datos PostgreSQL 16 con migraciones automáticas gestionadas por el framework
- Documentación OpenAPI generada automáticamente desde anotaciones del código
- Licencia AGPL-3.0 que garantiza transparencia y libertad para modificaciones
- Estado beta temprano con cambios frecuentes en la API y posibles inestabilidades
- Requiere infraestructura específica como PostgreSQL o CloudNativePG para producción
- No incluye frontend, debe integrarse con librarium-web o servicios externos
- Dependencia de River para colas que añade complejidad operativa
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.
Para producción, use imágenes multi-arch de GHCR con tags explícitos (ej. :26.4.0) y nunca :latest. Configure JWT_SECRET y POSTGRES_PASSWORD en variables de entorno o secrets manager. Para Kubernetes, prefiera Helm con CloudNativePG si ya lo usa, o manifests nativos para control total. Asegure el puerto 8080 del API detrás de un proxy inverso (nginx en web) que exponga /api.
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.