AudioMuse-AI Helm Chart

This repository contains the official Helm chart for installing AudioMuse-AI on K3S. AudioMuse-AI is an open-source music analysis and automatic playlist generator that integrates with Jellyfin, Navidrome, and Lyrion media servers.

The full list of AudioMuse-AI related repositories:

• AudioMuse-AI — the core application, running Flask and Worker containers
• AudioMuse-AI Helm Chart — Helm chart for easy installation on Kubernetes (this repo)
• AudioMuse-AI Plugin for Jellyfin — Jellyfin plugin
• AudioMuse-AI Plugin for Navidrome — Navidrome plugin
• AudioMuse-AI MusicServer — Open Subsonic-compatible music server with integrated sonic functionality

Table of Contents

• What this chart deploys
• Quick install (defaults)
• Custom install (recommended)
• Choosing the AudioMuse-AI version
• Advanced configuration
• How to Uninstall

What this chart deploys

PostgreSQL, Redis, Flask, and Worker. After install, open the app UI and complete the setup wizard to configure your media server, authentication, and AI provider — those settings live in the app database, not in values.yaml.

Quick install (defaults)

helm repo add audiomuse-ai https://NeptuneHub.github.io/AudioMuse-AI-helm
helm repo update

helm install my-audiomuse audiomuse-ai/audiomuse-ai \
  --namespace audiomuse \
  --create-namespace

The app is reachable at <LoadBalancer-IP>:8000 once pods are ready.

Note: the default PostgreSQL password is audiomusepassword. Fine for trying it out — must be changed for production (see below).

Custom install (recommended)

Create my-values.yaml:

postgres:
  password: "your-strong-postgres-password"

timezone: "Europe/Rome"   # optional, defaults to "UTC"

The built-in Redis has no auth (cluster-internal only). If you use an external Redis with auth, include the password in redis.external.url — see Advanced configuration.

Install with those values:

helm install my-audiomuse audiomuse-ai/audiomuse-ai \
  --namespace audiomuse \
  --create-namespace \
  --values my-values.yaml

Choosing the AudioMuse-AI version

By default the chart pulls latest from ghcr.io/neptunehub/audiomuse-ai. To pin a specific version, add image.tag to your values:

image:
  tag: "1.1.3"

Available tags: https://github.com/NeptuneHub/AudioMuse-AI/pkgs/container/audiomuse-ai

Advanced configuration

See values.yaml for the full reference. Common overrides:

• External PostgreSQL (e.g. CloudNativePG): postgres.enabled: false + postgres.external.host: ...
• External Redis: redis.enabled: false + redis.external.url: "redis://user:pass@host:6379/0"
• Use an existing Kubernetes Secret for postgres credentials: postgres.existingSecret: "my-secret" (with existingSecretKeys to remap CNPG-style key names)
• Ingress: set ingress.enabled: true with hosts and tls per the example in values.yaml

How to Uninstall

helm uninstall my-audiomuse -n audiomuse

To also remove the namespace and its persistent volume claims:

kubectl delete namespace audiomuse