BD Human Parser Preview
Finally see what the human parser actually saw
- parse_map
- preview
The human parser nodes are powerful but opaque. A HUMAN_PARSE_MAP is a struct, not an image - you can't see it, which makes debugging "why is the hair mask wrong" genuinely annoying. BD_HumanParserPreview fixes that in one move: it colorizes the map with a fixed 18-class palette and hands you an RGB image you can actually look at.
It's the debug/visualization node in the pack's human-parser family, and honestly the one you'll want in the graph while you tune the others, even if you don't keep it in the final pipeline. It's also handy for dumping a color-coded segmentation image as a deliverable - a "what we parsed" overlay for a pipeline that needs one.
How it works
Each of the 18 class indices maps to a fixed color in the pack's palette - background is black, face gets a skin-tone beige, hair a brown, top a crimson, and so on through 18 distinct colors. The node takes the class map and paints each pixel with its class color, producing a straightforward RGB preview IMAGE.
There are no inputs beyond parse_map and no settings. That's deliberate: a fixed palette means the same class always renders the same color, so once you learn that the pink region is "dress," that knowledge transfers to every image you preview. A stable legend is worth more than per-session random colors.
The one real limitation to know: it colorizes classes, not confidence. It won't tell you where the parser was unsure - if you want to see confidence, that's the parser node's confidence_threshold territory. What this gives you is a fast visual read of the segmentation layout.
Where it sits
Upstream you'll have BD Fashn Human Parser or BD ATR Human Parser; downstream you'll usually want BD Human Parser Mask Split or Named Mask for the actual masks. Preview is the one you hang off to the side - wire the map into it as well as the split node, and you get both the masks and the eyeball check in the same run.
Install
Part of the BrainDead pack:
cd ComfyUI/custom_nodes
git clone https://github.com/BizaNator/ComfyUI-BrainDead
cd ComfyUI-BrainDead
pip install -r requirements.txt
Or search "BrainDead" in ComfyUI Manager and restart. No extra dependencies - it's palette mapping over the class array.
Troubleshooting
- Preview is mostly black - the parser saw mostly background (common on heavily cropped inputs), or the map came from a backend whose classes don't line up with the palette's expectation. Check which parser produced it.
- Two similar regions are hard to tell apart - the 18-color palette is fixed, so adjacent colors can be close (e.g. skin-tone beige vs. some clothing hues). Zoom in or check the specific mask output instead.
Inputs (1)
| Name | Type | Default | Description |
|---|---|---|---|
| parse_map | HUMAN_PARSE_MAP | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| preview | IMAGE | — |