whatisgithub

What is comfyui_ipadapter_plus?

cubiq/comfyui_ipadapter_plus — explained in plain English

Analysis updated 2026-06-26

5,957PythonAudience · designerComplexity · 3/5Setup · hard

In one sentence

ComfyUI extension that lets you use a reference photo to guide the style, composition, or face likeness of AI-generated images, without writing any text style prompts.

Mindmap

mindmap
  root((ipadapter plus))
    What it does
      Image style transfer
      Reference photo input
      Face identity matching
    Features
      SD 1.5 and SDXL models
      Unified model loader
      Workflow example files
    Setup
      ComfyUI extension
      HuggingFace model download
    Status
      Maintenance only since 2025
      Community pull requests
Click or tap to explore — scroll the page freely

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

Apply the visual style of a reference photo to new AI-generated images without writing a text style description.

USE CASE 2

Generate portraits that preserve a specific person's face across multiple different scenes or backgrounds.

USE CASE 3

Transfer the color palette and composition of one image to a newly generated artwork using the style transfer model.

USE CASE 4

Load a ready-made workflow file to start experimenting with style transfer immediately without building a node graph.

What is it built with?

PythonComfyUI

How does it compare?

cubiq/comfyui_ipadapter_plusom-ai-lab/vlm-r1snorkel-team/snorkel
Stars5,9575,9565,960
LanguagePythonPythonPython
Setup difficultyhardhardeasy
Complexity3/55/53/5
Audiencedesignerresearcherdata

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires ComfyUI already installed plus separate model file downloads from HuggingFace, in maintenance-only mode as of April 2025.

So what is it?

ComfyUI IPAdapter Plus is an extension for ComfyUI, a node-based tool for generating images with AI. The extension adds support for IPAdapter models, which let you use a reference image to influence how newly generated images look. Instead of describing a style in words, you provide a photo, and the model applies its visual character to the output. The README describes it as a one-image LoRA, meaning it works similarly to a style preset but driven entirely by an example image. The extension supports a range of pre-trained model files covering different use cases: basic style transfer, stronger style transfer, portrait-focused generation that captures a specific person's face, and face identity models that preserve a subject's likeness across multiple generations. There are variants for both SD 1.5 and SDXL base models. All model files are downloaded separately from HuggingFace and placed in specific folders within the ComfyUI directory. Installation involves cloning the repository into ComfyUI's custom_nodes folder or using the ComfyUI Manager. After installing, the extension adds new nodes to ComfyUI's visual graph editor. A Unified Model Loader node can automatically detect and load the correct models when files are named according to the naming convention described in the README. Older loader nodes still work with any file names but require manual selection. The examples directory includes ready-made workflow files that demonstrate the full range of features. Several video tutorials are also linked in the README covering basic usage, style and composition transfer, attention masking, and animation features. As of April 2025, the repository entered maintenance-only mode. The author no longer actively develops it, though critical pull requests may still be considered.

Copy-paste prompts

Prompt 1
I have ComfyUI installed and want to add IPAdapter Plus. Walk me through cloning the repo into custom_nodes, downloading the SD 1.5 model files from HuggingFace, and naming them correctly for the Unified Loader.
Prompt 2
Show me how to set up a ComfyUI workflow using the Unified Model Loader node so it auto-detects the right IPAdapter model based on the file name.
Prompt 3
I want to generate images that match a reference photo's art style but with different subjects. Which IPAdapter model should I use and how do I adjust the style strength?
Prompt 4
How do I use the face identity IPAdapter model to keep a specific person's face consistent across 10 different scene prompts in a batch ComfyUI workflow?

Frequently asked questions

What is comfyui_ipadapter_plus?

ComfyUI extension that lets you use a reference photo to guide the style, composition, or face likeness of AI-generated images, without writing any text style prompts.

What language is comfyui_ipadapter_plus written in?

Mainly Python. The stack also includes Python, ComfyUI.

How hard is comfyui_ipadapter_plus to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is comfyui_ipadapter_plus for?

Mainly designer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.