Skip to content

Files

Latest commit

5f1e91d · Feb 19, 2025

History

History
108 lines (89 loc) · 7.49 KB

README.md

File metadata and controls

108 lines (89 loc) · 7.49 KB

中文文档

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

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 save api extended 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
    # restart ComfyUI

Tips:

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

For GGUF models you will need to install ComfyUI-GGUF

PuLID models

Nodes

  • PulidFluxModelLoader
  • PulidFluxInsightFaceLoader
  • PulidFluxEvaClipLoader
  • ApplyPulidFlux
    • Solved the model pollution problem of the original plugin ComfyUI-PuLID-Flux
    • 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)
  • 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.
    • 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).

Thanks

ToTheBeginning/PuLID

ComfyUI-PuLID-Flux

TeaCache

Comfy-WaveSpeed