SELF-HOSTED · OPEN SOURCE
Run your own SUB/WAVE.
SUB/WAVE points at your Navidrome library and your LLM — a local Ollama box by default, or any hosted provider you prefer. Once it's running, the AI DJ broadcasts from your homelab, plays from your music collection, and answers requests from anyone with the URL.
THE FAST PATH
Already have Docker, Navidrome, and an LLM reachable? One curl, two Enters, and the station is on the air — the installer chains straight into init and start, then setup finishes the configuration.
curl -fsSL https://cli.getsubwave.com | sh
subwave setupThe installer drops the subwave binary, then prompts Run subwave init now? — say yes and it walks the install dir (default ~/subwave), deployment shape (prod / prod-byo), and admin credentials. init ends with Bring the stack up now? — yes again brings up Docker. Then setup prompts for Navidrome and your LLM, persists everything, and renders the station jingles. Full walkthrough →
After that, subwave status / logs / doctor / restart / update drive the station from anywhere on your shell — no cd into a project dir, no clone required. Prefer pure docker compose? Manual Install covers that path.
IF YOU'RE NEW HERE
Start at Prerequisites.
SUB/WAVE talks to services it doesn't ship, so a couple of things need to be running first. Prerequisites covers them, then pick whichever install path suits you — they all land at the same place:
- Quick Start — The standalone CLI — install once, init / setup / start, done.
- Manual Install — No CLI on your host — pure docker compose, same outcome.
- Development — Hacking on SUB/WAVE itself — the three compose files and hot reload.
Just want to listen to a station, not run one? The manual covers tuning in and making requests.