musik
Servidor de música auto-alojado que convierte una biblioteca local en un servicio de streaming personal con Web UI, API, radio personalizada y Daily Mix usando embeddings CLAP.
Ficha actualizada 22 sept 2026, 18:16 · upstream 22 sept 2026, 15:45 · release sin release detectada
Qué es musik
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Musik es un servidor de música self-hosted diseñado para transformar una colección local de archivos MP3, FLAC y otros formatos en un servicio de streaming privado. El sistema utiliza embeddings acústicos generados por CLAP para analizar el sonido de los tracks, permitiendo recomendaciones basadas en características auditivas más allá de metadatos tradicionales como género o artista.
La arquitectura combina Python para tareas de procesamiento (escaneo, análisis acústico, generación de misiones) con Go para la API, streaming y Web UI. Utiliza SQLite como base de datos principal para almacenar la biblioteca, historial de escucha y preferencias del usuario. El sistema soporta autenticación mediante contraseña para la interfaz web y tokens Bearer para la API.
Funcionalidades clave incluyen radio personalizada que aprende del comportamiento del usuario, creación automática de Daily Mixes, reproducción en navegador o dispositivos móviles, búsqueda avanzada y gestión de favoritos e historial. La solución está optimizada para funcionar tanto en hardware con GPU como en entornos CPU-only.
- Escaneo automático de bibliotecas locales MP3/FLAC con lectura de metadatos y análisis acústico
- Radio personalizada que adapta recomendaciones según gustos, historial y contexto temporal
- Daily Mixes automáticos basados en embeddings CLAP y preferencias del usuario
- API RESTful para integración con aplicaciones externas o control programático
- Web UI responsive compatible con navegadores modernos y dispositivos móviles
- Arquitectura híbrida Go/Python optimizada para streaming y procesamiento de audio
- Soporte nativo para embeddings CLAP que permiten recomendaciones por similitud acústica
- Base de datos SQLite persistente con soporte para migración de cachés a servidores sin GPU
- Autenticación robusta con tokens Bearer, cookies de sesión y límites de tasa IP
- Pipeline de escaneo automático que procesa nuevos archivos añadidos a la biblioteca
- Requiere una colección de música legalmente adquirida por el usuario; no descarga ni distribuye contenido
- Diseñado para un único propietario; no soporta gestión multi-usuario o compartición pública
- Dependencia de GPU recomendada para embeddings CLAP en bibliotecas grandes (>50k tracks)
- Requiere configuración manual de variables de entorno MUSIK_* para despliegue seguro
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 con Docker usando docker-compose.yml. Copiar .env.example a .env y generar secretos con openssl. Montar biblioteca musical en directorio data/music (o configurar MUSIK_LIBRARY). Ejecutar make up para iniciar player:8787 y worker:8790. Para bibliotecas grandes, calcular embeddings en máquina con GPU y migrar data/db/musik.db + data/cache/embeddings/ a servidor objetivo.
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.