ComfyUI Extension: ComfyUI_PuLID_Flux_ll

Authored by lldacing

Created 11 months ago

Updated 15 days ago

436 stars

The implementation for PuLID-Flux, support TeaCache, no model pollution.

Custom Nodes (8)

README

中文文档

Solved ComfyUI-PuLID-Flux model pollution problem.
🆕 Commercial-friendly FaceNet implementation - Alternative to InsightFace for commercial usage without licensing restrictions.
Supported use with TeaCache (Need use with ComfyUI_Patches_ll).
Supported use with Comfy-WaveSpeed, supported by Comfy-WaveSpeed in commit-36ba3c8.
Supported simple use with First Block Cache (Can use with ComfyUI_Patches_ll).

Must uninstall or disable ComfyUI-PuLID-Flux and other PuLID-Flux nodes before install this plugin. Due to certain reasons, I used the same node's name ApplyPulidFlux.

Need upgrade ComfyUI Version>=0.3.7

🏢 Commercial Usage Ready

This plugin now supports FaceNet-based face analysis as an alternative to InsightFace, making it suitable for commercial applications:

No ArcFace licensing restrictions - FaceNet is freely available for commercial use
Compatible API - Drop-in replacement for InsightFace workflows
Production ready - Reliable face detection and embedding generation

Simply use PulidFluxFaceNetLoader instead of PulidFluxInsightFaceLoader in your workflows.

Update logs

2025.02.19

Fix: when selecting a face from multiple faces as a reference, embeddings and alignment features maybe not from the same face.

2025.02.18

Supported selecting a face from multiple faces as a reference. Example workflow.

2025.01.27

Changed the model path of facexlib to ComfyUI/models/facexlib/.
When automatically downloading, modify the path of Antelope v2 model to ComfyUI/models/insightface/models/antelopev2/.
Changed the model path of EVA_CLIP_L_14_336 to ComfyUI/models/clip/.

Preview (Image with WorkFlow)

save api extended

Install

Manual

    cd custom_nodes
    git clone https://github.com/lldacing/ComfyUI_PuLID_Flux_ll.git
    cd ComfyUI_PuLID_Flux_ll
    pip install -r requirements.txt
    pip install facenet-pytorch --no-deps
    # restart ComfyUI

Tips:

If you use ComfyUI_windows_portable and encounter the following error, please see https://github.com/deepinsight/insightface/issues/2576

insightface/thirdparty/face3d/mesh/cython/mesh_core_cython.cpp(36): fatal error C1083: 无法打开包括文件: "Python.h": No such file or directory
      error: command 'd:\\installed\\Microsoft Visual Studio\\2022\\BuildTools\\VC\\Tools\\MSVC\\14.42.34433\\bin\\HostX86\\x64\\cl.exe' failed with exit code 2
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for insightface
Failed to build insightface

Models

Available Flux models

32bit/16bit (~22GB VRAM): model, encoder
8bit gguf (~12GB VRAM): model, encoder
8 bit FP8 e5m2 (~12GB VRAM): model, encoder
8 bit FP8 e4m3fn (~12GB VRAM): model, encoder
Clip and VAE (for all models): clip, vae

For GGUF models you will need to install ComfyUI-GGUF

PuLID models

Download PuLID-Flux => ComfyUI/models/pulid/.
(Support auto-download) Download EVA02-CLIP-L-14-336 => ComfyUI/models/clip/.

Face Analysis Models

For Commercial Use (Recommended):

FaceNet - No additional downloads required! Uses facenet-pytorch with pre-trained VGGFace2 models
- ✅ Commercial license friendly
- ✅ Automatic download model (Model vggface2 will be downloaded to ~/.cache/torch/checkpoints/20180402-114759-vggface2.pt)
- ✅ Automatic model loading
- Use with PulidFluxFaceNetLoader node

For Non-Commercial/Research Use:

(Support auto-download) Download all models like *.onnx from AntelopeV2 => ComfyUI/models/insightface/models/antelopev2/.
(Support auto-download) Download parsing_bisenet, parsing_parsenet and Resnet50 => ComfyUI/models/facexlib/.
- Use with PulidFluxInsightFaceLoader node

Nodes

PulidFluxModelLoader
- See chapter PuLID models
PulidFluxFaceNetLoader 🆕
- Commercial-friendly face analysis using FaceNet
- No additional model downloads required
- Compatible with all PuLID workflows
- Supports CPU and CUDA execution
PulidFluxInsightFaceLoader
- Traditional InsightFace-based analysis
- See chapter PuLID models
PulidFluxEvaClipLoader
- See chapter PuLID models
ApplyPulidFlux
- Solved the model pollution problem of the original plugin ComfyUI-PuLID-Flux
- Works with both FaceNet and InsightFace - seamless compatibility
- attn_mask ~~may not work correctly (I have no idea how to apply it, I have tried multiple methods and the results have been not satisfactory)~~ works now.
- If you want use with TeaCache, must put it before node FluxForwardOverrider and ApplyTeaCachePatch.
- If you want use with Comfy-WaveSpeed, must put it before node ApplyFBCacheOnModel.
FixPulidFluxPatch (Deprecated)
- If you want use with TeaCache, must link it after node ApplyPulidFlux, and link node FluxForwardOverrider and ApplyTeaCachePatch after it.
PulidFluxOptions
- input_faces_order - Sorting rule for detected bboxes.
  - left-right: Sort the left boundary of bbox by column from left to right.
  - right-left: Reverse order of left-right (Sort the left boundary of bbox by column from right to left).
  - top-bottom: Sort the top boundary of bbox by row from top to bottom.
  - bottom-top: Reverse order of top-bottom (Sort the top boundary of bbox by row from bottom to top).
  - small-large: Sort the area of bbox from small to large.
  - large-small: Sort the area of bbox from large to small.
- input_faces_index - The target index of the sorted bboxes.
- input_faces_align_mode - Choose the detection method for aligning facial features.
  - 0: Old version method, When there is a face in an image, the selected facial embedding amount and alignment features maybe not consistent.
  - 1: Keep the selected facial embedding amount and alignment features consistent.
  - There is a slight difference between the two mode, with the align_face value of 1 resulting smaller area than the embed_face value of 0.
PulidFluxFaceDetector
- Can check the facial features applied in ApplyPulidFlux.
- Works with both FaceNet and InsightFace backends
- When input_faces_align_mode = 0, the embed_face and align_face should be the same face, but they are generated by different detectors, and the number detected may be not consistent, so they may be not the same face.
- When input_faces_align_mode = 1, the embed_face and align_face are always the same face, they are generated by same detectors.
- face_bbox_image - Draw the detected facial bounding box (the result of the embed_face's detector).

Usage Examples

Commercial Workflow (FaceNet)

PulidFluxFaceNetLoader -> ApplyPulidFlux

Research Workflow (InsightFace)

PulidFluxInsightFaceLoader -> ApplyPulidFlux

Both workflows produce compatible results and can be used interchangeably.

Thanks

facenet-pytorch - For commercial-friendly face recognition