Extensions/ComfyUI-PuLID-Flux2
ComfyUI Extension

ComfyUI-PuLID-Flux2

PuLID adaptation for Flux.2 bringing consistent identity to generated images using face embedding and visual feature injection into Flux.2 model.

By iFayens·Created 6 months ago·Updated 4 months ago· 119
iFayens/ComfyUI-PuLID-Flux2
Nodes5
On cloudLocal install
CategoryPuLID-Flux2
Stars119
Updated4 months ago

Nodes (5)

Apply PuLID ✦ Flux.2

The node that makes Flux.2 stop inventing new faces

PuLID-Flux2
Load EVA-CLIP (PuLID)

The EVA-CLIP loader that does nothing but download 800MB once

PuLID-Flux2
PuLID — Face Preview

The face preview node

PuLID-Flux2
Load InsightFace (PuLID)

Pick CPU, CUDA, or ROCM and let it find the faces

PuLID-Flux2
Load PuLID ✦ Flux.2

Why 'Load PuLID ✦ Flux.2' only shows 'create new' (and how to fix it)

PuLID-Flux2
Readme

ComfyUI-PuLID-Flux2

🔥 Bring consistent identity to FLUX.2 in one node

🚀 v0.6.2 — improvements 👉 https://huggingface.co/Fayens/Pulid-Flux2

  • First working PuLID adaptation for Flux.2 — supports Klein (4B / 9B & Dev)

🚀 What's new (v0.6.2)

  • ✅ Improved face recognition
  • ✅ Less artifacts
  • ✅ Added native Klein weights (v1 & v2)

🖼️ Results

///

⚡ Quick Start

  1. Load your Flux.2 model
  2. Add Apply PuLID ✦ Flux.2 node
  3. Use recommended settings:
    • strength = 1.0 (normal)
    • strength = 1.4 (recommended)
  4. Generate

Done ✅

🧠 How it works (simple)

  • Face embedding → InsightFace
  • Visual features → EVA-CLIP
  • Converted into identity tokens
  • Injected into Flux.2 model

➡️ Result: consistent identity across generations

📦 Installation

🟢 Quick Install (recommended)

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

📥 Download weights

👉 https://huggingface.co/Fayens/Pulid-Flux2

Place in: ComfyUI/models/pulid/

📥 Required models

InsightFace (AntelopeV2)

👉 https://huggingface.co/MonsterMMORPG/InstantID_Models/tree/main/models/antelopev2

Place in:

ComfyUI/models/insightface/models/antelopev2/

PuLID weights

Place in:

ComfyUI/models/pulid/
  • Existing PuLID weights supported
  • Native Flux.2 weights (recommended, in progress)

⚠️ Notes

  • EVA-CLIP downloads automatically (~800MB)
  • Do NOT install eva_clip from GitHub
  • If ComfyUI already works → don’t use full requirements.txt

⚠️ Training

Training scripts have been temporarily removed due to instability and bugs. They will be reintroduced in a future update once fully stable and reliable. Thanks for your patience.

🔌 Available Nodes

  • Load InsightFace (PuLID)
  • Load EVA-CLIP (PuLID)
  • Load PuLID ✦ Flux.2
  • Apply PuLID ✦ Flux.2 ⭐ (main node)
  • Face Debug Preview

⚠️ Current Status

| Feature | Status | | -------------------- | -------------- | | Flux.2 Klein support | ✅ Best | | Flux.2 Dev support | ✅ Working | | Identity consistency | ✅ Strong | | Native weights | ✅ (v1 & v2) |

🚀 Roadmap

  • Native trained weights (Klein)
  • Edit mode (img2img)
  • Body consistency
  • HuggingFace release

🙏 Credits

  • PuLID original: https://github.com/ToTheBeginning/PuLID
  • Flux.2: Black Forest Labs
  • EVA-CLIP: BAAI
  • Adaptation: @iFayens

⭐ Support

If this project helps you, consider giving it a ⭐ on GitHub — it really helps.

You can also support future development:

👉 https://buymeacoffee.com/fayens

Thank you 🙏