ComfyUI-Egregora-Audio-Super-Resolution
✨ High‐quality music audio enhancement for ComfyUI: FlashSR Super‐Resolution + Fat Llama spectral enhancement (GPU & CPU).
Package profile
- Status
- Verified
- Publisher
- @lucasgattas
- Source
- GitHub
README
ComfyUI Egregora Audio Super Resolution
A focused audio toolkit for ComfyUI: upscale, enhance, and evaluate audio quality with a clean, practical workflow. This pack is built for real-world use: minimal setup, clear node purposes, and tools to verify results.
Project scope (what this is and is not)
What it is:
- A set of audio enhancement nodes (FlashSR + Fat Llama) plus evaluation tools (ABX, loudness, null tests).
- Designed to help you improve low-quality audio and measure changes reliably.
What it is not:
- Not a magical "increase bitrate" tool. It enhances signal content and writes a new file at a chosen format/bitrate.
- Not a replacement for professional mastering. Think of it as an audio cleanup/boost stage.
Nodes overview (what each one does)
1) Audio Super Resolution (FlashSR)
Purpose: Diffusion-based upsampler aimed at musical content. It resamples internally to 48 kHz and can resample output back to your target rate.
Best for:
- Low to mid quality music or wideband content
- Improving detail and clarity in band-limited audio
Inputs:
audio(AUDIO)lowpass_input(BOOL) gentle LPF before inferenceoutput_sr(48000 / 44100 / 96000)
Outputs:
- One AUDIO buffer
Use case:
- Feed an audio file node -> FlashSR -> Preview Audio
2) Spectral Enhance (Fat Llama GPU)
Purpose: Iterative spectral enhancement using CuPy on GPU.
Best for:
- Noisy or compressed audio
- Sharpening "sparkle" and spectral detail
Inputs:
target_format(wav / flac)max_iterations(higher = more aggressive, slower)threshold_value(controls spectral gating)target_bitrate_kbps(target write bitrate)toggle_normalize(on by default)toggle_autoscale(on by default)
Outputs:
- One AUDIO buffer
Use case:
- Audio -> Fat Llama GPU -> Preview
3) Spectral Enhance (Fat Llama CPU/FFTW)
Purpose: CPU fallback using FFTW. Same idea as GPU but slower.
Use case:
- When you don´t have CUDA/CuPy
4) Enhance Extras
Purpose: Denoise, dereverb, and codec tools you can chain in front of FlashSR or Fat Llama.
Includes:
- RNNoise Denoise
- DeepFilterNet 2/3 Denoise
- WPE Dereverb
- DAC encode/decode
5) Eval Pack
Purpose: Measure loudness, distortion, and quality.
Includes:
- Loudness meter (LUFS approx)
- Gain match (LUFS/RMS)
- ABX preparation/judge
- Spectral metrics (SI-SDR, LSD)
- High quality resampler
6) Null Test Suite
Purpose: See exactly what changed between A and B by aligning and subtracting signals.
Includes:
- Alignment (GCC-PHAT)
- Gain match
- Null output and plots
How to combine nodes (common workflows)
Clean + enhance (recommended chain)
- Denoise/Dereverb (Extras)
- FlashSR (optional)
- Fat Llama (light pass)
- Eval Pack or Null Test to verify
FlashSR only
- Audio -> FlashSR -> Preview
Fat Llama only
- Audio -> Fat Llama -> Preview
Installation
1) Copy node pack
Place this folder into:
ComfyUI/custom_nodes/ComfyUI-Egregora-Audio-Super-Resolution
Restart ComfyUI once.
2) Install dependencies (recommended)
Use ComfyUI´s embedded Python:
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Egregora-Audio-Super-Resolution
equirements.txt
python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Egregora-Audio-Super-Resolution\install.py
Notes:
- Torch/torchaudio are not installed here to avoid breaking ComfyUI.
- On Windows,
install.pyinstalls NVIDIA CUDA runtime wheels for CuPy.
FlashSR repo and weights
The node auto-downloads the FlashSR inference repo on first use into deps/FlashSR_Inference/:
https://github.com/jakeoneijk/FlashSR_Inference
However, FlashSR model weights are not included in this p
Nodes in this pack
19 nodes
Nodes in this pack
19 nodes- ABX Judge
- ABX Prepare
- Audio Align (XCorr)
- Audio Gain Match
- Audio Gain Match (1770)
- Audio Null Test
- Audio Plotter
- Egregora_DAC_Decode
- Egregora_DAC_Encode
- Egregora_DeepFilterNet_Denoise
- Egregora_RNNoise_Denoise
- Egregora_WPE_Dereverb
- EgregoraAudioUpscaler
- EgregoraFatLlamaCPU
- EgregoraFatLlamaGPU
- Loudness Meter (BS1770)
- Metrics (LSD + SI-SDR)
- Null Test (Full)
- Resample Audio (HQ)
Sources
3 sources
Sources
3 sourcesVerified Oct 23
Verified Oct 23
Source excerpts
1 excerpt
Source excerpts
1 excerptSource context: Repo lucasgattas/ComfyUI-Egregora-Audio-Super-Resolution
