Skip to content

iFayens/ComfyUI-PuLID-Flux2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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


⭐ 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 🙏

About

First PuLID implementation for FLUX.2 — Consistent face identity in ComfyUI

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages