🎨 Qwen Image 2512 + SAM3 Face Inpainting Workflow

> Generate stunning portraits with automatic face detail enhancement — using single prompts or batch scheduling.

## ✨ What This Workflow Does

This ComfyUI workflow combines Qwen Image 2512 (a powerful text-to-image model) with SAM3 Smart Inpainter to:

1. 🖼️ Generate high-quality images from text prompts

2. 👤 Automatically find and enhance faces (man + woman) using AI segmentation

3. 🔁 Support single prompt OR batch prompt scheduling for creative variations

4. ⚡ Speed up generation with CacheDiT acceleration

5. 🎯 Use advanced sampling for better results

Perfect for: character portraits, fashion shoots, story illustration, face refinement, and creative batch generation.

## ✨ What's New in V1.1

### 🔁 Auto-Reset Counter (No More Manual Reset!)

- Replaced the old PrimitiveInt node with my new AutoResetInt node

- ✅ Automatically resets to 0 after each generation

- ✅ Also resets if you cancel a generation

- ✅ Want to run multiple batches? Just wait for the first image to finish — the counter resets itself!

- 🎯 No more forgetting to reset — just click "Queue" and go

### ⚙️ Model Format Switch

- Added a simple toggle to choose your model format:

- GGUF — for lower VRAM / quantized setups

- FP8 / BF16 — for full quality on powerful GPUs

- 🎯 Pick what works best for your hardware — no need to edit the workflow

## 📦 Required Custom Nodes

Install these in your ComfyUI/custom_nodes/ folder:

| Node Pack | Purpose | Link |

|-----------|---------|------|

| RES4LYF | Advanced sampler with better quality control | https://github.com/ClownsharkBatwing/RES4LYF |

| SAM3_SmartInpainter | Auto-detect & inpaint faces using SAM3 | https://github.com/majidfida/SAM3_SmartInpainter |

| ComfyUI-CacheDiT | Speed up Qwen Image generation | https://github.com/Jasonzzt/ComfyUI-CacheDiT |

| comfyui_auto_prompt_schedule | Run multiple prompts in one batch | https://github.com/ReinerBforartists/comfyui_auto_prompt_schedule |

### Also Required:

- ComfyUI-Easy-Sam3 or ComfyUI-RMBG (provides the sam3 Python package for SAM3_SmartInpainter)

- Qwen Image model files: qwen_image_vae.safetensors, qwen_2.5_vl_7b_fp8_scaled.safetensors, and your chosen checkpoint (e.g., Qwen-Overcooked_fp8_V2.safetensors)

- SAM3 model: Download sam3.pt from https://huggingface.co/Majidfida/Sam3/tree/main → place in ComfyUI/models/sam3/

## 🔧 How to Use

### Step 1: Install & Setup

1. Clone all required node packs into custom_nodes/

2. Install Python requirements (see each repo's README)

3. Download models and place them in correct folders

4. Restart ComfyUI

### Step 2: Load the Workflow

1. Drag the .json file into ComfyUI

2. Wait for nodes to load (missing nodes will show red)

### Step 3: Choose Your Mode

#### 🎯 Single Prompt Mode (Default)

- Set the toggle true=Single Prompt | false=Batch Prompts → true

- Edit the prompt in the ⚡Single Prompt⚡ node

- Click Queue Prompt

#### 🔄 Batch Prompt Mode

- Set the toggle → false

- Edit prompts in the Input Prompts for Schedule node (format: "0": "prompt text", "30": "next prompt", ...)

- Set max_frames in PromptSchedule node to control how many to generate

- Click Queue Prompt — it will auto-run through your list

### Step 4: Face Inpainting (Automatic)

The workflow automatically:

1. Finds the woman's face → enhances it with prompt: "woman, exquisite detailed face..."

2. Finds the man's face → enhances it with prompt: "man with dark beard, exquisite detailed face..."

3. Blends both back into the main image

💡 Tip: To inpaint different subjects, chain more SAM_SmartInpainter nodes and change the prompt field (e.g., "hat", "eyes", "scarf").

### Step 5: Adjust Key Settings

| Parameter | Recommended | What It Does |

|-----------|-------------|--------------|

| min_mask_area | 0.001 | Allows tiny faces to be detected |

| crop_padding | 32–128 | Extra space around face for better inpainting |

| inpaint_resolution | 1280 | Higher = more detail in repainted face |

| denoise | 0.3–0.5 | Lower = subtle changes, higher = more creative |

| steps | 6 | Qwen Image works well with low steps |

| cfg | 1.0 | Keep low for Qwen Image |

---

## 💡 Pro Tips

🔹 Small or distant faces not detected?

→ Lower min_mask_area to 0.0005 and text_threshold to 0.25

🔹 Inpainting looks blurry?

→ Raise inpaint_resolution to 1280 or 1536

🔹 Edges look harsh?

→ Use blend_mode: feather and increase mask_blur

🔹 Want to inpaint more than faces?

→ Change the SAM prompt to "hat", "logo", "hands" — it will find and repaint that area

🔹 Batch generation too slow?

→ Enable CacheDiT and use fp8 models for faster runs

## ⚠️ Important Notes

🔸 This workflow is designed for Qwen Image 2512 — other models may need parameter adjustments

🔸 I do not monitor this post — I may not reply to comments or issues. This is shared for the community to use and improve.

🔸 Always test with one image first before running large batches

---

## 🙏 Credits

- Qwen Image 2512 — Alibaba Cloud / Qwen Team

- SAM3 Model — Meta AI Research / Majidfida (HuggingFace)

- RES4LYF — @ClownsharkBatwing

- SAM3_SmartInpainter — @majidfida

- CacheDiT — @Jasonzzt

- Auto Prompt Schedule — @ReinerBforartists

> 🎨 Simple rule: Start with single prompt → get it perfect → then try batch mode for variations.

> If faces aren't found → lower min_mask_area. If results look soft → raise inpaint_resolution.

Happy creating! ✨👫🖼️