corpus
Dashboard auto-alojado para historial de escucha compatible con ListenBrainz y Last.fm. Utiliza DuckDB para almacenamiento, Elm para la interfaz web y S3/MinIO para caché de portadas. Requiere instalación manual vía Nix o pnpm.
Ficha actualizada 26 sept 2026, 22:59 · upstream 26 sept 2026, 22:31 · release v3.4.0
Qué es corpus
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Corpus es una herramienta para visualizar el historial de escucha almacenando scrobbles en DuckDB, añadiendo metadatos de release y cacheando arte de portada. Sirve una interfaz web compilada con Elm que consume datos de ListenBrainz o Last.fm mediante su API proxy.
La configuración se gestiona principalmente a través de un archivo users.json para usuarios estáticos y variables de entorno para secretos compartidos, como claves de Discogs o AWS. Soporta validación de tokens y permite habilitar la métrica Prometheus en /metrics.
El despliegue no utiliza Docker por defecto, sino que depende de entornos con Nix o gestores de paquetes Node.js (pnpm). Es ideal para usuarios técnicos que buscan un dashboard ligero sin dependencias de contenedores.
- Visualizar historial de escucha en tiempo real
- Sincronizar datos entre ListenBrainz y Last.fm
- Gestionar usuarios estáticos con configuración JSON
- Exportar métricas a Prometheus para monitoreo
- Base de datos DuckDB para consultas rápidas
- Interfaz web compilada con Elm
- Caché de portadas en S3/MinIO
- Configuración ligera sin Docker
- No incluye Dockerfile ni Compose
- Requiere instalación manual vía Nix o pnpm
- Gestión manual de tokens de usuario
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.
Configurar CORPUS_USERS_FILE y DATABASE_PATH. Para caché, definir S3_BUCKET y credenciales AWS. Habilitar METRICS_ENABLED=true para Prometheus. Usar just shell con Nix o pnpm install localmente. No usar en producción sin autenticación adecuada si se habilita registro público.
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.