Load PuLID ✦ Flux.2

Every PuLID setup starts here. Load PuLID ✦ Flux.2 (PuLIDModelLoader) is the node that finds your PuLID weights on disk and hands the model to the Apply node. It has exactly one job and one input, and its whole personality is a single dropdown listing every .safetensors, .pt, or .bin file sitting in your pulid folder.

The catch: if that folder is empty, or the node can't see it, the dropdown shows only __create_new__. Pick that and it constructs an untrained PuLID model on the spot. The code will happily return it to you, and then Apply PuLID will happily use it, and your output will be garbage - the weights do all the work. "Create new" exists because the author's training script builds models this way, but the training scripts are currently pulled from the repo as unstable. For generation, "create new" is a trap, not a feature.

Where the weights live

The node reads from ComfyUI/models/pulid/ - note the lowercase pulid, which has burned people on case-sensitive Linux and macOS systems. The author's recommended weights are the native Flux.2 versions (v1 and v2, the v0.6.2 update added Klein-native weights) from Fayens/Pulid-Flux2 on HuggingFace, named something like pulid_flux_klein_v2.safetensors. Existing Flux.1 PuLID weights (e.g. pulid_flux_v0.9.1.safetensors) are also accepted - the node auto-detects the hidden dimension from the file and dimension-matches it to your Flux.2 variant - but quality is lower than the native Klein weights, and several people have reported weak likeness with the Flux.1 files.

Install

This node ships in the iFayens/ComfyUI-PuLID-Flux2 pack, so install the pack once:

cd ComfyUI/custom_nodes
git clone https://github.com/iFayens/ComfyUI-PuLID-Flux2.git
cd ComfyUI-PuLID-Flux2
pip install insightface onnxruntime-gpu open-clip-torch safetensors ml_dtypes==0.3.2

(Or ComfyUI Manager → search "ComfyUI-PuLID-Flux2".) Then download the weights and put them in ComfyUI/models/pulid/. Restart ComfyUI - or at minimum refresh the node list - or the new file won't show up in the dropdown.

The "only shows create new" fix

This is the single most-reported problem with the pack, and it's almost never a bug - it's folder placement:

1. Close ComfyUI.
2. Make sure the weights are in ComfyUI/models/pulid/ (lowercase pulid, not Pulid - the code creates the folder itself on first load if it doesn't exist, so let it).
3. Restart and re-add the node, which re-reads the folder.

If it still only shows "create new" after that, check the file extension - only .safetensors, .pt, and .bin are listed. And if you've been fighting a Windows/macOS case mismatch, delete any hand-made Pulid folder, let ComfyUI create the lowercase one, and drop the files there. That exact sequence resolves the open issue in the repo's tracker.

The output, PULID_MODEL, wires into the pulid_model input of Apply PuLID ✦ Flux.2. That's the whole node - load weights, hand them over.