Nodul vine din pachetul custom ComfyUI-Impact-Pack (ltdrdata), categoria ImpactPack/Simple. Descrierea lui: detectează obiecte cu modele de detecție (bbox, segm, SAM), mărește zona găsită după guide_size și o regenerează. Este făcut pentru fețe, dar funcționează pentru orice inpainting automat, după modelul de detecție ales. Pe lângă imagine primește model, clip, vae, condiționările positive / negative și aceiași parametri ca un KSampler (seed, steps, cfg, sampler, scheduler, denoise).
Detectorul vine pe intrarea bbox_detector. Din Impact Pack V8.0, nodul UltralyticsDetectorProvider, care încarcă modelele YOLO, este în pachetul separat ComfyUI-Impact-Subpack și trebuie instalat separat. Modelele se pun în models/ultralytics/bbox (detecție) sau models/ultralytics/segm (segmentare); Bingsu/adetailer pe Hugging Face are, de exemplu, face_yolov8m.pt și hand_yolov8s.pt. Opțional, SAMLoader (Impact) dă un model SAM pe sam_model_opt, pentru o mască mai precisă.
Din V7.6 instalarea automată nu mai există: pachetul se instalează din Manager sau manual (git clone în custom_nodes, apoi pip install -r requirements.txt în mediul ComfyUI). Ieșirile sunt imaginea finală (image), lista zonelor regenerate, decupate (cropped_refined), aceleași zone cu canal alfa (cropped_enhanced_alpha), masca, un detailer_pipe pentru alte noduri Detailer și cnet_images. FaceDetailer (pipe) face același lucru cu intrările grupate, pentru mai multe treceri.
Concepte cheie și caracteristici
| Concept / Parametru | Descriere practică |
|---|---|
guide_size / guide_size_for / max_size |
Mărimea la care se regenerează zona (implicit 512, raportată la bbox sau la zona decupată) și limita ei (implicit 1024). |
denoise |
0.0001–1.0, implicit 0.5: cât din zona detectată se regenerează. |
feather |
Estomparea marginii la lipire, implicit 5. |
bbox_threshold / bbox_dilation / bbox_crop_factor |
Pragul de detecție (0.5), extinderea casetei (10 px) și cât context se decupează în jurul ei (3.0). |
sam_detection_hint / sam_threshold |
Cum se folosește SAM (implicit center-1) și pragul lui (0.93). |
drop_size |
Ignoră detecțiile mai mici de atâția pixeli (implicit 10). |
wildcard |
Prompt separat pentru zonele detectate. |
cycle |
De câte ori se repetă regenerarea (1–10, implicit 1). |
bbox_detector |
De la UltralyticsDetectorProvider (Impact Subpack). |
sam_model_opt / segm_detector_opt |
Opționale: model SAM sau detector de segmentare. |
Exemple practice și scenarii reale
Exemplul 1: Restaurarea fețelor după generare
models/ultralytics/bbox/face_yolov8m.pt
UltralyticsDetectorProvider (bbox/face_yolov8m.pt) -> FaceDetailer.bbox_detector
VAE Decode.IMAGE -> FaceDetailer.image
Load Checkpoint.MODEL/.CLIP/.VAE, CLIP Text Encode (+/-) -> FaceDetailer
FaceDetailer: guide_size 512, steps 20, denoise 0.5 -> Save Image
Exemplul 2: Același nod pentru mâini
UltralyticsDetectorProvider (bbox/hand_yolov8s.pt) -> FaceDetailer.bbox_detector
Exemplul 3: Instalare manuală (Impact Pack și Subpack)
cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack comfyui-impact-pack
git clone https://github.com/ltdrdata/ComfyUI-Impact-Subpack
cd comfyui-impact-pack && pip install -r requirements.txt
cd ../ComfyUI-Impact-Subpack && pip install -r requirements.txt
Greșeli frecvente și capcane
- Instalezi doar Impact Pack și nu găsești UltralyticsDetectorProvider. Din V8.0 este în ComfyUI-Impact-Subpack.
- Cauți un nod „HandDetailer”. Nu există; folosești FaceDetailer cu un detector de mâini.
- Pui
denoisela 1.0 ca să „repari” fața. Zona se regenerează complet și poate să nu mai semene cu persoana sau cu unghiul inițial; pornește de la valoarea implicită 0.5 și ajustează.