whatisgithub

What is comfyui-ultimate-face-fix?

merserk/comfyui-ultimate-face-fix — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

In one sentence

ComfyUI nodes that automatically detect and repair faces in AI-generated or existing images using your own connected generation model.

Mindmap

mindmap
  root((repo))
    What it does
      Detects faces in images
      Repairs faces with your model
      Blends result seamlessly
    Tech stack
      Python
      ComfyUI
      YOLO detection
      SAM masking
    Use cases
      Fix generated faces
      Support anime and realism
      Custom crop pipelines
    Audience
      ComfyUI users
      AI image creators
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically detect and repair one or many faces in an AI-generated image.

USE CASE 2

Fix faces in anime, illustrated, or realistic style images using a matching generation model.

USE CASE 3

Build a custom face-crop enhancement pipeline with the Extract and Process nodes.

USE CASE 4

Use ready-made example workflows to fix faces with SDXL or Krea 2 Turbo.

What is it built with?

PythonComfyUIYOLOSAM

How does it compare?

merserk/comfyui-ultimate-face-fix0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ComfyUI with a compatible image generation model already connected.

You can use and modify it, but if you run a modified version as a network service, you must share your source code under the same license.

So what is it?

ComfyUI Ultimate Face Fix is a set of add-on tools for ComfyUI, a visual, node-based program used to generate images with AI. This add-on focuses specifically on repairing faces in generated or existing images, whether there is one face or several in the same picture. It works by first detecting each face, then repairing a cropped square around it using whatever image generation model you already have connected, and finally blending the repaired face back into the original picture using a precise mask so the edges do not look obvious. It supports many popular image generation models, including different versions of Stable Diffusion, FLUX, and several others, and it can handle anime, illustrated, and realistic art styles. Installing it is done through ComfyUI Manager by searching for its name and clicking install, which also downloads the extra face detection models it needs automatically. There is also a manual installation option for people who prefer to clone the project directly and run a setup script themselves. Once installed, the tool adds several new nodes you can drag into your workflow. The main node offers many adjustable settings, such as how many faces to fix, how strongly to change each face, what size to resize each face crop to before processing, and how to blend the repaired face back in. There are also optional connections for more advanced face detection and masking tools if you want finer control. For people who want more customization, the project includes separate extract and process nodes so you can add your own image editing steps to the face crop before it gets repaired. There is also an automatic denoise helper that looks at detected faces and suggests a reasonable repair strength based on their size. The project ships several ready-made example workflows to help new users get started quickly. The code is released under the AGPL-3.0-or-later license, while any downloaded model files keep their own separate licensing terms.

Copy-paste prompts

Prompt 1
Help me install ComfyUI-Ultimate-Face-Fix through ComfyUI Manager and set up the required face models.
Prompt 2
Show me how to connect the face detector, face parser, and Ultimate Face Fix nodes into my workflow.
Prompt 3
Explain what detection_quality, repair_mode, and blend_mode settings do so I can pick the right ones.
Prompt 4
Walk me through using the Extract and Process nodes to add custom enhancement before face repair.
Prompt 5
Show me how to use the Auto Denoise node to pick a good repair strength automatically.

Frequently asked questions

What is comfyui-ultimate-face-fix?

ComfyUI nodes that automatically detect and repair faces in AI-generated or existing images using your own connected generation model.

What language is comfyui-ultimate-face-fix written in?

Mainly Python. The stack also includes Python, ComfyUI, YOLO.

What license does comfyui-ultimate-face-fix use?

You can use and modify it, but if you run a modified version as a network service, you must share your source code under the same license.

How hard is comfyui-ultimate-face-fix to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is comfyui-ultimate-face-fix for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.