Skip to content

About

"SimSwap-ComfyUI"

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ComfyUI-SimSwap

ComfyUI 自定义节点,基于 SimSwap 实现人脸交换(Face-Swapping)。

功能

  • 一键换脸:将源图像中的人脸身份迁移到目标图像的人脸上
  • 支持多人脸:目标图像中包含多张人脸时,全部替换
  • 两种分辨率:支持 224×224 和 512×512(HQ)两种对齐尺寸
  • 可选遮罩:使用人脸解析遮罩实现更平滑的融合效果

安装

cd ComfyUI/custom_nodes/
git clone https://github.com/yourname/ComfyUI-SimSwap.git
cd ComfyUI-SimSwap
pip install -r requirements.txt

依赖说明

  • insightface — 人脸检测 + 关键点定位(自动下载 antelope 模型)
  • onnxruntime-gpu — InsightFace 的 ONNX 推理后端(如需 CPU 可换 onnxruntime)
  • huggingface-hub — 自动下载 SimSwap 模型权重

模型下载(自动)

首次运行节点时,会自动从 HuggingFace 下载以下模型到 ComfyUI/models/simswap/:

模型 文件 大小
ArcFace ID Extractor arcface_checkpoint.tar ~130 MB
SimSwap Generator latest_net_G.pth ~340 MB
InsightFace Antelope (自动下载到模型目录) ~200 MB

下载链接来自 eziorojas/simswap-models。

节点说明

SimSwap Face-Swap

输入 类型 说明
source_image IMAGE 提供身份信息的人脸图像
target_image IMAGE 要被替换人脸的目标图像
crop_size [224, 512] 对齐裁剪尺寸(224 为原始版,512 为 HQ 版)
use_mask BOOLEAN 是否启用遮罩融合(需额外下载 BiSeNet 模型)
输出 类型 说明
swapped_image IMAGE 换脸结果图像

工作流示例

[Load Image: source] → [SimSwap Face-Swap] → [Save Image]
[Load Image: target] →                      → [Preview Image]

注意事项

  1. GPU 要求:建议使用 NVIDIA GPU(CUDA),CPU 模式速度较慢
  2. 人脸大小:目标图像中的人脸像素面积建议 > 80×80 以获得较好效果
  3. 多人脸:源图像中检测到的最高置信度人脸作为身份来源;目标图像中所有检测到的人脸均被替换
  4. 遮罩模式:use_mask=True 时需额外下载 BiSeNet 解析模型,融合更自然但速度略慢

致谢

About

"SimSwap-ComfyUI"

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages