Hera
Hera is a self-hosted music recommendation and music discovery service with automated downloading powered by Last.fm and Downtify.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
45/100 Fair
- Maintained
- 71last commit 69 days ago
- Popular
- 102 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 26 days ago
- GitHub stars
- 2
- Open issues
- 0
- Last commit
- 2026-09-13
- License
- GPL-3.0
- Activity
- stale
Checked 8 days ago - source: GitHub (athuull/hera)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install Hera with pip first Run `pip install hera` in your project's terminal. Hera is a Python helper that creates Argo workflow definitions, so without this package your Hera scripts will fail because Python cannot find it. source
- You need an Argo cluster to run workflows If you want to run examples, set up k3d (a tiny local Kubernetes cluster tool) and the Argo Workflows controller using the documented `make install-k3d run-argo` step in the Codespaces/Make setup. Without that cluster, Hera can create workflow definitions, but Argo cannot actually run them. source
Fetched 54 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I point Hera at my music folder and settings location?
Mount a local directory to /music/downloads for downloaded music and another to /config for settings. The defaults are ./music and ./config, and MUSIC_DIR and CONFIG_DIR can be overridden in a .env file.
Do I need any extra services or credentials for Hera to download music?
Yes, the Docker Compose setup includes a Downtify service and uses DOWNTIFY_API_URL so Hera can perform downloads. You also need to enter your Last.fm API key and username in the settings panel.
How does Hera avoid downloading duplicate tracks?
It indexes local files and ID3 tags before downloading using multi-tier deduplication. This includes exact title normalization, unicode support, distinctive title extraction, and artist matching.
What audio formats and metadata options can I configure?
Hera supports MP3 up to 320 kbps CBR, FLAC, M4A, and Opus output. It can also configure cover art resolution, include synced .lrc lyrics, and use ffmpeg to convert .webm files to .mp3.
Can Hera automatically fetch and limit recommendation downloads?
It can run automated cron downloads on a configurable schedule, such as nightly. New tracks are fetched and downloaded automatically up to a daily limit.
Answers sourced from github.com
Community
Collected 53 days ago - public community threads