Welcome to this user-friendly guide on utilizing the ComfyUI InstantID Faceswapper! This tool is based on [InstantID](https://github.com/InstantID/InstantID) and designed for seamless image manipulation, perfect for generating facial swaps in your projects. The tool is highly effective, especially when paired with the LCM Lora technology.
Getting Started: Installation Guide
To get you started, follow these steps to successfully install the ComfyUI InstantID Faceswapper:
- Clone or download the repository and place it into the ComfyUI/custom_nodes directory.
- Open a command line interface in the ComfyUI/custom_nodes/comfyui-instantId-faceswap folder and type:
- Manually download the required files and create necessary folders following this structure:
- ComfyUI/models/insightface/models/antelopev2 – Place the following files here:
- 1k3d68.onnx
- 2d106det.onnx
- genderage.onnx
- glintr100.onnx
- scrfd_10g_bnkps.onnx
- ComfyUI/models/ipadapter – Put the file ip-adapter.bin here.
- ComfyUI/models/controlnet/ControlNetModel – Place these files here:
- diffusion_pytorch_model.safetensors
- config.json
- ComfyUI/models/loras (Optional but highly recommended) – Download pytorch_lora_weights.safetensors here.
- Ensure your file structure looks like this:
pip install -r requirements.txt
ComfyUI/
└── models/
├── ipadapter/
│ └── ipadapter.bin
├── controlnet/
│ └── ControlNetModel/
│ ├── config.json
│ └── diffusion_pytorch_model.safetensors
└── insightface/
└── models/
└── antelopev2/
├── 1k3d68.onnx
├── 2d106det.onnx
├── genderage.onnx
├── glintr100.onnx
└── scrfd_10g_bnkps.onnx
Custom Nodes Overview
Once installation is complete, you can use various custom nodes for advanced manipulation:
- Faceswap LCM Lora: Specify the path to your LCM lora.
- Faceswap Setup: Load everything and initiate pipeline setup with parameters like checkpoint, controlnet, and ipadapter.
- Faceswap Face Embed: Prepare face embeddings to enhance results.
- Faceswap Generate: Generate faces from input images using a variety of parameters for fine-tuning the output.
Creating Workflows
Workflows are essential to utilize the faceswap tool efficiently. Example workflows can be located in the workflows folder. You can create a custom workflow using the workflow_generate.py script to automatically connect nodes based on input images.
python workflow_generate.py /path/to/input_folder output_workflow_file_name
Troubleshooting Tips
If you encounter issues, here are some troubleshooting suggestions:
- If you’re seeing artifacts instead of proper images, increase the resize option value or decrease the padding parameter.
- If colors seem off, try adjusting the number of steps or the ip_adapter_scale value.
- For “No face detected” errors, check the padding and adjust accordingly.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Conclusion
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

