Skip to main content

airadio — local AI radio with MiniMax Music 3

airadio is your personal radio station using your local install of ComfyUI and MiniMax Music 3.

It generates ~2-minute songs over ComfyUI’s normal HTTP API, plays them with tail fades, and fills gaps with interstitials or library tracks until the next song is ready.

pip install airadio
# start ComfyUI yourself (with MiniMax Music 3), then:
airadio

Each new song gets a random two-word title that primes generation and becomes part of the filename (velvet-garden4289-l00000428.wav). Vocal songs use a recursive phrase grammar to compose new lines and new song forms. A persistent station-local lyric ID and complete-text hash prevent a finished lyric from being selected again across restarts.

Airadio currently generates vocal songs only. The released local Music 3 weights do not provide a reliable track-level instrumental control: tag-only requests can add wordless vocals or collapse into incoherent audio. Airadio therefore does not label those outputs as instrumentals and has no hosted-API fallback; generation stays on your self-hosted ComfyUI instance.

What you need

  1. ComfyUI running locally (default http://127.0.0.1:8188)
  2. MiniMax Music 3 installed into that ComfyUI (nodes + model files)
  3. Linux playback (pw-play or aplay), ffmpeg / ffprobe, Python 3.10+

airadio does not start ComfyUI for you and does not need comfy-cli or any side “Music 3” client. If it can’t talk to ComfyUI, it tells you to start or install it, then exit.

Install airadio

pip install airadio
# or from source:
git clone https://github.com/Decentricity/interdimensional-radio.git
cd interdimensional-radio
pip install -e .

Install ComfyUI + MiniMax Music 3

Follow the official guides (Music 3 lives inside ComfyUI):

  1. ComfyUI — https://github.com/comfyanonymous/ComfyUI
  2. MiniMax Music 3 — https://docs.comfy.org/tutorials/audio/minimax/minimax-music-3

That guide covers the model files. Use the low-VRAM INT8 set if you have ~12 GB VRAM (same set this project was tested with).

Start ComfyUI the normal way so it listens on port 8188, then run:

airadio

Optional: keep radio data (library, interstitials, staging) in a custom folder:

export AIRADIO_HOME="$PWD"   # auto-detected if ./library exists
airadio

CLI

Command Purpose
airadio Start the radio loop
airadio run Same as above
airadio title Print random two-word song titles
airadio interstitials lyrics CLIP.wav Print the exact input lyrics for an interstitial
airadio interstitials info CLIP.wav Show its generation parameters and hashes
airadio interstitials audit Verify all current clips and archived generations

How it works

┌─────────┐     HTTP :8188      ┌─────────────────────────────┐
│ airadio │ ──────────────────▶ │ Your ComfyUI + Music 3      │
└────┬────┘                     └─────────────────────────────┘
     │
     ├── library/         saved songs
     ├── interstitials/   gap-fill clips
     └── .radio-staging/  in-flight generation
  1. Check — can airadio reach ComfyUI with Music 3 nodes? If not, print install/start help and exit.
  2. Pipeline — while a song plays, the next one generates in the background.
  3. Fill — if gen is not ready: interstitials, then a library track; repeat.
  4. Archive — finished songs land in library/ with catalog metadata.

Generation retries transient failures up to three times. Ctrl-C stops playback, releases the station lock, and exits cleanly. Catalog and lyric-state updates use atomic file replacement so an interrupted write cannot leave half-written JSON.

Interstitial provenance

Every newly generated interstitial is committed with the exact lyrics supplied to the local model. Beside each playable WAV, Airadio stores a human-readable .lyrics.txt file and a .provenance.json record containing hashes, source script, caption, seed, requested duration, backend, and generation time.

Successful generations are append-only. An independent copy of each WAV and its inputs lives under interstitials/provenance/history/, so regenerating a clip does not erase its earlier audio or script. The atomic interstitials/provenance/catalog.json identifies the current generation and the complete history for every filename.

The recorded lyrics are the exact input supplied to Music3 or Piper. A local audio model can still mispronounce, slur, or improvise what is heard in the WAV.

Hardware

Tested on NVIDIA GeForce RTX 4070 Ti (12 GB VRAM) with the INT8 MiniMax Music 3 weights (~11 GB on disk; ~10–11 GB VRAM for a 120s generation).

Environment variables

Variable Default Meaning
AIRADIO_HOME ~/.local/share/airadio (or cwd if library/ exists) Radio data root
IDR_ROOT (alias for AIRADIO_HOME) Legacy name
AIRADIO_COMFY_HOST 127.0.0.1 ComfyUI host
AIRADIO_COMFY_PORT 8188 ComfyUI port
AIRADIO_PROMPTS bundled package prompts Override prompt directory
AIRADIO_LYRICS_GRAMMAR bundled recursive grammar Override the lyric grammar JSON
AIRADIO_STAGING_KEEP 20 Diagnostic prompt, failed-output, and playback files retained per kind

Prompts and titles

Bundled under the package:

  • Caption templates and a recursive phrase-level lyric grammar
  • Title word lists for two-word song names
  • Interstitial scripts and prompts

The lyric grammar follows the recursive symbol/rules approach demonstrated by Galaxy Kate's Tracery: small phrase symbols expand into lines, song-scoped symbols keep imagery consistent, and a separate grammar chooses the complete song form. Airadio uses a small Python-native expander for this subset rather than requiring JavaScript.

License

Application code: MIT (see LICENSE).

MiniMax Music 3 weights are distributed separately under their own terms by MiniMax / Comfy-Org.

Metadata

Release files for airadio 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airadio 0.4.3
File Size Uploaded Provenance Actions
airadio-0.4.3.tar.gz 62.4 kB Without provenance Details for airadio-0.4.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for airadio 0.4.3
File Interpreter ABI Platform Actions
airadio-0.4.3-py3-none-any.whl Python 3 none any Details for airadio-0.4.3-py3-none-any.whl

Total release size: 158.2 kB

Release files / airadio-0.4.3.tar.gz

Download URL airadio-0.4.3.tar.gz
Size 62.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e937eecc5e7dd0f403e02940ba7d3b181e6e548b83ac7c9e6f35c30abf57b3bb
BLAKE2b-256 checksum
How to use checksums
9f8960546628a47e1399d8e6f10860c7c881601379f9d36b6cd49bd3b190c6b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / airadio-0.4.3-py3-none-any.whl

Download URL airadio-0.4.3-py3-none-any.whl
Size 95.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
04ded5e8af2b47a2398f0fb14150d246d821b8cbdb57c733661f975a846a95a9
BLAKE2b-256 checksum
How to use checksums
933e684a1071593a61ffa3228a3cd38dd9d66cf404ed09ea6a37bf3a5bcedee5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for airadio 0.4.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page