System Check

What it is

System Check is the honest answer to the question every ComfyUI pack leaves you asking: why doesn't this work, and what am I missing? It reads your machine, your ComfyUI version, which of the pack's model files are actually installed for each template, which optional packages are present, and the pack's own hardware table - with your machine's row marked.

It's template 0, and it's the first thing to run after installing. It changes nothing. No downloads, no settings, no repairs. It just tells you where you stand, which is more useful than another pack's silent best-guess.

How it works

detail is the only widget. summary gives you the readable overview; full appends the raw facts as JSON - which is also the thing you attach to a bug report, and what the pack's troubleshooting doc asks for specifically.

What it reports, roughly in the order you'll need it:

• Versions. ComfyUI (the pack needs 0.37.0 or newer, because it builds on the native YuE2, SheetSage2, MiniMax Music 3, FLUX.2, text-generation and loop nodes upstream) and the Plenio version. If you see older than the supported 0.37.0, that's your answer to red nodes and missing node types.
• GPUs and VRAM. The number that decides which checkpoint you should be loading.
• Per-template model files. Which files each template still needs, so "missing models" isn't a guess and Value not in list for ckpt_name isn't a mystery.
• Optional packages. Whether faster-whisper is installed - the one pip install this pack can want, for lyrics transcription of covers.
• Plenio assets. The ASR weights and anything else fetched on demand.
• The offline / download policy. Because a machine with PLENIO_AUTO_DOWNLOAD=0 behaves differently from one that will go and fetch a 3 GB model for you.
• The hardware rule table with your row marked: below 8 GB, 8–12 GB, 12–16 GB, 16–24 GB, 24 GB+ - what's practical for YuE2, MiniMax Music 3 and the optional FLUX.2 Klein cover art.

The node also re-runs every time, deliberately: its fingerprint is invalidated unconditionally, because facts about your machine change outside the graph and a cached "everything is fine" is worse than useless.

Output is report, a PLENIO_REPORT you can read on the node or wire into Export Release for the release record - so the file knows which machine and which versions made it.

Install

# ComfyUI Manager → Custom Nodes Manager → search "Plenio Music Production System"
# or by hand:
cd ComfyUI/custom_nodes
git clone https://github.com/jplenio/Plenio-Music-Production-System
# Comfy CLI:
comfy node install comfyui-plenio-music

Restart, then open 0 · System Check from ComfyUI's template browser (templates are listed under the package's folder name) and run it. This is also the template that shows in App mode as a simple form, which is all it needs to be.

Common issues

• The templates aren't in the browser. Either your ComfyUI predates 0.37.0, or the pack failed to import. Look for Plenio and Cannot import in the console at startup.
• "Package 'av' / 'PIL' / 'scipy' is not installed." That's a broken ComfyUI environment rather than a Plenio problem - the pack installs nothing and expects ComfyUI's own requirements to be there. Reinstall them in ComfyUI's Python.
• "Plenio configuration error." user/plenio/config.toml has an invalid key or value. It says which; until you fix it, Plenio runs on defaults.
• It reports missing files you're sure you have. Check the folder as well as the name - wrong file, wrong directory (sheetsage2_bf16.safetensors belongs in models/audio_encoders) or a differently-named conversion, and ComfyUI treats it as absent.
• A user template you saved doesn't appear. The console says skipped the user template … with the reason - usually a front-matter line missing its colon. Fix or delete the file and refresh.