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
the filename (velvet-garden4289.wav).
What you need
- ComfyUI running locally (default
http://127.0.0.1:8188) - MiniMax Music 3 installed into that ComfyUI (nodes + model files)
- Linux playback (
pw-playoraplay),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):
- ComfyUI — https://github.com/comfyanonymous/ComfyUI
- 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 |
How it works
┌─────────┐ HTTP :8188 ┌─────────────────────────────┐
│ airadio │ ──────────────────▶ │ Your ComfyUI + Music 3 │
└────┬────┘ └─────────────────────────────┘
│
├── library/ saved songs
├── interstitials/ gap-fill clips
└── .radio-staging/ in-flight generation
- Check — can airadio reach ComfyUI with Music 3 nodes? If not, print install/start help and exit.
- Pipeline — while a song plays, the next one generates in the background.
- Fill — if gen is not ready: interstitials, then a library track; repeat.
- Archive — finished songs land in
library/with catalog metadata.
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 |
Prompts and titles
Bundled under the package:
- Caption / lyrics templates for generation
- Title word lists for two-word song names
- Interstitial scripts and prompts
License
Application code: MIT (see LICENSE).
MiniMax Music 3 weights are distributed separately under their own terms by MiniMax / Comfy-Org.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file airadio-0.3.2.tar.gz.
File metadata
- Download URL: airadio-0.3.2.tar.gz
- Upload date:
- Size: 42.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49054d734b5c81421c396b4e4cfec36f6f79af05aaca6e7a525b858ae27cd998
|
|
| MD5 |
d7d7c5b35daf0a8e424497920c52f17d
|
|
| BLAKE2b-256 |
df2ec137211731736e3b273f8e637ced2cd0420124fb21893bbb969ff5cb3f93
|
File details
Details for the file airadio-0.3.2-py3-none-any.whl.
File metadata
- Download URL: airadio-0.3.2-py3-none-any.whl
- Upload date:
- Size: 81.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
082c2c9d6ded4e1ae675842f98197e1e66f63357e836e7dc355095c03c6d68ed
|
|
| MD5 |
0b2a12ba576d3c323069c06fab389a16
|
|
| BLAKE2b-256 |
4354825ebca0fd65cbc1a7270587ef5b91da80ab6bcf246caf6aa487bf55eb7f
|