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 the filename (velvet-garden4289.wav).

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

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.

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

airadio-0.3.0.tar.gz (42.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

airadio-0.3.0-py3-none-any.whl (81.3 kB view details)

Uploaded Python 3

File details

Details for the file airadio-0.3.0.tar.gz.

File metadata

  • Download URL: airadio-0.3.0.tar.gz
  • Upload date:
  • Size: 42.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for airadio-0.3.0.tar.gz
Algorithm Hash digest
SHA256 5ced85210dc30392514eaa2002a47a43f37e64667ca10d6bc5b530bbc323dc69
MD5 d74bff8598e4262b4d01928d16f63656
BLAKE2b-256 58138568c424d5ef1d458a9bb3d04ca14b850526fd37bd43e832914a74bf3dff

See more details on using hashes here.

File details

Details for the file airadio-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: airadio-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 81.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for airadio-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc50f87ee6085d23a5780a3e4f50a2231cab2407a158adbd81791314e9e35af2
MD5 961809143bf14345acf6b0bf54b20354
BLAKE2b-256 138c28eb89e6bf5971ae7768f2d64ccb0ef2a47cf32348e2a95268e63c80b10b

See more details on using hashes here.

Release history Release notifications | RSS feed

0.3.2

2 files

0.3.1

2 files

This release

0.3.0 This release

2 files

0.2.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page