selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

AudioMuse-AI logo

Self-host AudioMuse-AI

v3.7.2

Sonic-analysis playlist generator for your music server

ReleaseOpen SourceAGPL-3.0
Updatedyesterday
LanguagePython
Setup difficultyModerate
Stars
2 962
CPU
4-core Intel with AVX2 support (usually produced in 2015 or later) or ARM
RAM
8 GB
Storage
NVME SSD
Port
8000 (Web UI and REST API served by the Flask container)
Requires
PostgreSQL
Docker
ghcr.io/neptunehub/audiomuse-ai
Install with Docker Compose
AudioMuse-AI screenshot 1AudioMuse-AI screenshot 2AudioMuse-AI screenshot 3AudioMuse-AI screenshot 4AudioMuse-AI screenshot 5

What is AudioMuse-AI?

Should you self-host AudioMuse-AI?

AudioMuse-AI scores 66/100 on selfhost.directory (how scoring works) and ranks #6 of 59 in Music Streaming. It has 2 962 GitHub stars, +244 in the last 30 days.

It shipped 41 stable releases in the past year. The latest, v3.7.2, came out on 16 November 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is koel (75/100, 17 353 stars). It scores higher overall, so compare the two before you pick. See AudioMuse-AI vs koel side by side.

Features

  • Audio clip identification
  • Audio-content (sonic) analysis
  • GPU AccelerationGPU clustering disabled by default
  • Listening-habit playlists
  • Lyrics / meaning search
  • Multiple music servers with duplicate detection
  • Music map visualization
  • Natural-language playlist generation
  • Plugin System
  • REST API with Swagger docs
  • Similar-song playlists
  • Song Alchemy vibe mixing
  • Song paths between two tracks
  • Sonic similarity clustering
  • Text search by mood, instrument, genre

AudioMuse-AI README

GitHub license Latest Tag Media Server Support: Navidrome 0.64.0, Jellyfin 12.1, LMS v3.69.0, Lyrion 9.0.2, Emby 4.9.1.80, Plex 1.43.2

⭐ Leave a star on this project: One shines alone; together, they make it visible and keep it alive.

💛 Donate to AudioMuse-AI this Christmas

Over 2,521 Navidrome users rely on AudioMuse-AI today (based on Navidrome anonymous usage statistics), and that's before counting all our Jellyfin, Emby, Plex, LMS and Lyrion users.

What started as a personal project now powers music libraries all over the world. AudioMuse-AI will always remain free and open source because I believe sonic analysis should be accessible to everyone, regardless of their budget. No ads, no paywalls, no subscriptions. Your music library is analyzed on your own server, keeping your data completely under your control.

However, keeping the project alive and moving forward takes ongoing resources: AI licenses, homelab infrastructure, research, and countless hours spent on releases and user support.

If you choose to donate €10, or whatever feels right for you, you will help keep AudioMuse-AI alive and growing throughout 2027.

Every single contribution makes a difference.

Thank you,

NeptuneHub

Maintainer of AudioMuse-AI

How to install AudioMuse-AI

Install AudioMuse-AI with Docker Compose

Environment variables
TZ, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_PORT, FRONTEND_PORT

Steps:

  1. Create your environment file:

    cp deployment/.env.example deployment/.env
    
  2. Start the services:

    docker compose -f deployment/docker-compose.yaml up -d
    
  3. Access the application:

    • Web UI: http://localhost:8000

CPU-only example is deployment/docker-compose.yaml; deployment/docker-compose-nvidia.yaml adds GPU with CPU fallback.

How to configure AudioMuse-AI

  • TZUTCSet the time zone of all containers (Flask, worker and PostgreSQL)
  • POSTGRES_USER*(N/A - from Secret)*(Required) PostgreSQL username.
  • POSTGRES_PASSWORD*(N/A - from Secret)*(Required) PostgreSQL password.
  • POSTGRES_DB*(N/A - from Secret)*(Required) PostgreSQL database name.
  • POSTGRES_HOSTpostgres-service.playlist(Required) PostgreSQL host.

AudioMuse-AI releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

What happens if my music server IDs change?

Existing mappings can break, making tracks look missing or duplicated. Recover by restoring the music-server backup, running a provider migration, cleaning stale entries, or as a last resort re-analyzing everything.

How to backup and restore the database?

Both are under Administration > Backup and Restore. Restore into the same PostgreSQL major version the backup came from, since container and native builds may bundle different versions.

Clustering takes a lot of time, how can I run it faster?

Reduce the Clustering Runs value from its default 1000 iterations; a few hundred already gives usable results on a small library.

Clustering returns playlists with too many songs.

Increase the min and max cluster counts and lower the stratified sampling target percentile, or lower the maximum playlist size target when automatic discovery is on.

What do the bars under the Machine Learning Models mean?

Each bar shows how complete that model's search index is, from one lit segment (just starting) to five (ready, above 95 percent). If one stays short after a run, start the analysis again so skipped songs are retried.

How long does the analysis take, and what if I interrupt it?

It depends on library size and hardware, ranging from hours to days. An interrupted run is safe to restart because already analyzed songs are kept in the database.

How do I start using AudioMuse-AI?

Open the frontend on port 8000 and run the Analysis first; that pass is mandatory before any other feature becomes usable.

How do I get the Plex auth token (X-Plex-Token)?

Sign in to the Plex Web App, open the browser network tab, refresh a library and copy the X-Plex-Token value from a request to your server.

Why does the Setup Wizard connection test fail with Jellyfin?

Usually wrong credentials: Jellyfin must be configured with the user's UID rather than the username. The steps to find the User ID are in the parameters docs.

How can I make the analysis faster?

Configure a lyrics source so Whisper transcription is skipped, add more worker containers on other machines, or as a last resort disable some machine-learning models.

Can AudioMuse-AI support multiple music libraries?

Yes: give one server a comma-separated library or folder filter, or attach several media servers (even several of the same kind) to one instance. A song present on two servers is analyzed once and mapped to both.

How to deploy AudioMuse-AI?

Follow the README and the examples in the deployment folder; only PostgreSQL and TZ are set through environment variables and everything else is configured in the browser Setup Wizard.

Which are the hardware requirements?

It runs on both ARM and Intel; the suggested setup is 4 cores, 8 GB RAM and an SSD. The NVIDIA images want a GPU with about 8 GB VRAM.

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…