[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Gourieff--ComfyUI-ReActor":3,"tool-Gourieff--ComfyUI-ReActor":62},[4,18,26,35,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,2,"2026-04-18T11:18:24",[14,15,13],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":32,"last_commit_at":41,"category_tags":42,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[43,13,15,14],"插件",{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[52,15,13,14],"语言模型",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,61],"视频",{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":97,"forks":98,"last_commit_at":99,"license":100,"difficulty_score":10,"env_os":101,"env_gpu":102,"env_ram":103,"env_deps":104,"category_tags":115,"github_topics":116,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":120,"updated_at":121,"faqs":122,"releases":151},9736,"Gourieff\u002FComfyUI-ReActor","ComfyUI-ReActor","Fast and Simple Face Swap Extension Node for ComfyUI (SFW)","ComfyUI-ReActor 是一款专为 ComfyUI 设计的高效换脸扩展节点，旨在让用户以简单快捷的方式实现图像中的人脸替换。它主要解决了在 AI 绘画工作流中集成高质量换脸功能的需求，同时特别注重内容安全，内置了裸露检测机制，确保生成内容符合全年龄段（SFW）标准，避免涉及不当素材。\n\n这款工具非常适合已经在使用 ComfyUI 进行创作的设计师、数字艺术家以及 AI 爱好者。无论是需要为角色更换面孔的插画师，还是希望快速验证创意原型的开发者，都能通过它轻松将换脸流程融入现有的节点工作流中。\n\n在技术亮点方面，ComfyUI-ReActor 不仅运行速度快，还持续引入前沿模型支持。最新版本实验性地优化了人脸修复逻辑，确保修复效果仅作用于被替换的面部区域，避免影响背景或其他细节。此外，它还新增了对 FaceFusion Labs 开发的 HyperSwap 模型的支持，提供了比传统模型更丰富的换脸风格选择，并配备了高级人脸修复节点，让用户能更精细地控制最终输出质量。作为一个开源项目，它在保持操作简便的同时，也为进阶用户提供了充足的自定义空间。","\u003Cdiv align=\"center\">\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d20593fd3647.png\" alt=\"logo\" width=\"180px\"\u002F>\n\n  ![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode_version-0.6.2_beta1-green?style=for-the-badge&labelColor=darkgreen)\n\n  \u003C!--\u003Csup>\n  \u003Cfont color=brightred>\n\n  ## !!! [Important Update](#latestupdate) !!!\u003Cbr>Don't forget to add the Node again in existing workflows\n  \n  \u003C\u002Ffont>\n  \u003C\u002Fsup>-->\n  \n  \u003Ca href=\"https:\u002F\u002Fboosty.to\u002Fartgourieff\" target=\"_blank\">\n    \u003Cimg src=\"https:\u002F\u002Flovemet.ru\u002Fimg\u002Fboosty.jpg\" width=\"108\" alt=\"Support Me on Boosty\"\u002F>\n    \u003Cbr>\n    \u003Csup>\n      Support This Project\n    \u003C\u002Fsup>\n  \u003C\u002Fa>\n\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Freactor_faceswap\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReActor-2CA5E0?style=for-the-badge&logo=Telegram&logoColor=white&labelColor=blue\">\u003C\u002Fimg>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Fartgourieff\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FArtGourieff-2CA5E0?style=for-the-badge&logo=Telegram&logoColor=white&labelColor=blue\">\u003C\u002Fimg>\u003C\u002Fa>\n\n  \u003Chr>\n  \n  [![Commit activity](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Ft\u002FGourieff\u002FComfyUI-ReActor\u002Fmain?cacheSeconds=0)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fcommits\u002Fmain)\n  ![Last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FGourieff\u002FComfyUI-ReActor\u002Fmain?cacheSeconds=0)\n  [![Opened issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FGourieff\u002FComfyUI-ReActor?color=red)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues?cacheSeconds=0)\n  [![Closed issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-closed\u002FGourieff\u002FComfyUI-ReActor?color=green&cacheSeconds=0)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues?q=is%3Aissue+state%3Aclosed)\n  ![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FGourieff\u002FComfyUI-ReActor)\n\n  English | [Русский](\u002FREADME_RU.md)\n\n# ReActor Nodes for ComfyUI\u003Cbr>\u003Csub>\u003Csup>-=SFW-Friendly=-\u003C\u002Fsup>\u003C\u002Fsub>\n\n\u003C\u002Fdiv>\n\n### The Fast and Simple Face Swap Extension Nodes for ComfyUI, based on [blocked ReActor](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241230084620\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node) - now it has a nudity detector to avoid using this software with 18+ content\n\n> By using this Node you accept and assume [responsibility](#disclaimer)\n\n\u003Cdiv align=\"center\">\n\n---\n[**What's new**](#latestupdate) | [**Installation**](#installation) | [**Usage**](#usage) | [**Troubleshooting**](#troubleshooting) | [**Updating**](#updating) | [**Disclaimer**](#disclaimer) | [**Credits**](#credits) | [**Note!**](#note)\n\n---\n\n\u003C\u002Fdiv>\n\n\u003Ca name=\"latestupdate\">\n\n## What's new in the latest update\n\n### 0.6.2 \u003Csub>\u003Csup>BETA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- Added support of HyperSwap models by FaceFusion Labs (thanks [@Buumcode](https:\u002F\u002Fgithub.com\u002FBuumcode) for contribution)\u003Cbr>You can download them [here](https:\u002F\u002Fhuggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain)\u003Cbr>(hyperswap_1a_256.onnx, hyperswap_1b_256.onnx, hyperswap_1c_256.onnx)\u003Cbr>and put them into the `ComfyUI\\models\\hyperswap` directory\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_dc06ad600d45.jpg\" alt=\"0.6.2-whatsnew-04-3\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n[Comparison grid](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.2_swapmodels_compare.png) of Inswapper vs Reswapper vs HyperSwap\n\n- Fixes and improvements\n\n### 0.6.2 \u003Csub>\u003Csup>ALPHA2, ALPHA3, ALPHA4\u003C\u002Fsup>\u003C\u002Fsub>\n\n- Small but important fixes\n\n### 0.6.2 \u003Csub>\u003Csup>ALPHA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- [Experimental] At last! Face restoration process affects only swapped faces\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_add262011c0a.jpg\" alt=\"0.6.2-whatsnew-01\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n- [Experimental] New Node \"Restore Face Advanced\" with Face Restore Filter, thanks https:\u002F\u002Fgithub.com\u002FBuumcode for implementation of \"Restore Face Filter\"\u003Cbr>This node helps you apply the restoration process to the face(s) you need\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6c876c0fb5d8.jpg\" alt=\"0.6.2-whatsnew-02\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n- Added FACE_MODEL_NAME output for \"Load Face Model\" node\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1da9a8723b94.jpg\" alt=\"0.6.2-whatsnew-03\" width=\"50%\"\u002F>\n\u003C\u002Fcenter>\n\n### 0.6.1\n\n- Gender detection better logic for many faces and many indexes\n- MaskHelper node 2x speed up - not perfect yet but 1.5x-2x faster then before\n- ComfyUI native ProgressBar for different steps\n- ORIGINAL_IMAGE output for main nodes\n- Different fixes and improvements (https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F25 fix; no tmp file for NSFW detector; NSFW detector little speed up)\n\n### 0.6.0\n\n- New Node `ReActorSetWeight` - you can now set the strength of face swap for `source_image` or `face_model` from 0% to 100% (in 12.5% step)\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d9ce19ccd39d.jpg\" alt=\"0.6.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_773f01a76317.jpg\" alt=\"0.6.0-whatsnew-02\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6b18ef5700a7.gif\" alt=\"0.6.0-whatsnew-03\" width=\"540px\"\u002F>\n\u003C\u002Fcenter>\n\n\u003Cdetails>\n\t\u003Csummary>\u003Ca>Previous versions\u003C\u002Fa>\u003C\u002Fsummary>\n\n### 0.5.2\n\n- ReSwapper models support. Although Inswapper still has the best similarity, but ReSwapper is evolving - thanks @somanchiu https:\u002F\u002Fgithub.com\u002Fsomanchiu\u002FReSwapper for the ReSwapper models and the ReSwapper project! This is a good step for the Community in the Inswapper's alternative creation!\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_2441dbaf33a9.jpg\" alt=\"0.5.2-whatsnew-03\" width=\"75%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_39e7690e261c.jpg\" alt=\"0.5.2-whatsnew-04\" width=\"75%\"\u002F>\n\u003C\u002Fcenter>\n\nYou can download ReSwapper models here:\nhttps:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\nJust put them into the \"models\u002Freswapper\" directory.\n\n- NSFW-detector to not violate [GitHub rules](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fsite-policy\u002Facceptable-use-policies\u002Fgithub-misinformation-and-disinformation#synthetic--manipulated-media-tools)\n- New node \"Unload ReActor Models\" - is useful for complex WFs when you need to free some VRAM utilized by ReActor\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_0b020fbf791a.jpg\" alt=\"0.5.2-whatsnew-01\" width=\"100%\"\u002F>\n\n- Support of ORT CoreML and ROCM EPs, just install onnxruntime version you need\n- Install script improvements to install latest versions of ORT-GPU\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_8430f433ad21.jpg\" alt=\"0.5.2-whatsnew-02\" width=\"50%\"\u002F>\n\u003C\u002Fcenter>\n\n- Fixes and improvements\n\n\n### 0.5.1\n\n- Support of GPEN 1024\u002F2048 restoration models (available in the HF dataset https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models)\n- ReActorFaceBoost Node - an attempt to improve the quality of swapped faces. The idea is to restore and scale the swapped face (according to the `face_size` parameter of the restoration model) BEFORE pasting it to the target image (via inswapper algorithms), more information is [here (PR#321)](https:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fpull\u002F321)\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1db26f9f73ab.jpg\" alt=\"0.5.1-whatsnew-01\" width=\"100%\"\u002F>\n\n[Full size demo preview](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.1-whatsnew-02.png)\n\n- Sorting facemodels alphabetically\n- A lot of fixes and improvements\n\n### [0.5.0 \u003Csub>\u003Csup>BETA4\u003C\u002Fsup>\u003C\u002Fsub>](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127121952\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.5.0)\n\n- Spandrel lib support for GFPGAN\n\n### 0.5.0 \u003Csub>\u003Csup>BETA3\u003C\u002Fsup>\u003C\u002Fsub>\n\n- Fixes: \"RAM issue\", \"No detection\" for MaskingHelper\n\n### 0.5.0 \u003Csub>\u003Csup>BETA2\u003C\u002Fsup>\u003C\u002Fsub>\n\n- You can now build a blended face model from a batch of face models you already have, just add the \"Make Face Model Batch\" node to your workflow and connect several models via \"Load Face Model\"\n- Huge performance boost of the image analyzer's module! 10x speed up! Working with videos is now a pleasure!\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_9c8bf8bab69c.png\" alt=\"0.5.0-whatsnew-05\" width=\"100%\"\u002F>\n\n### 0.5.0 \u003Csub>\u003Csup>BETA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- SWAPPED_FACE output for the Masking Helper Node\n- FIX: Empty A-channel for Masking Helper IMAGE output (causing errors with some nodes) was removed\n\n### 0.5.0 \u003Csub>\u003Csup>ALPHA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- ReActorBuildFaceModel Node got \"face_model\" output to provide a blended face model directly to the main Node:\n\nBasic workflow [💾](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002Fworkflows\u002FReActor--Build-Blended-Face-Model--v2.json)\n\n- Face Masking feature is available now, just add the \"ReActorMaskHelper\" Node to the workflow and connect it as shown below:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_52ae95901e3e.jpg\" alt=\"0.5.0-whatsnew-01\" width=\"100%\"\u002F>\n\nIf you don't have the \"face_yolov8m.pt\" Ultralytics model - you can download it from the [Assets](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt) and put it into the \"ComfyUI\\models\\ultralytics\\bbox\" directory\n\u003Cbr>\nAs well as [\"sam_vit_b_01ec64.pth\"](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fsams\u002Fsam_vit_b_01ec64.pth) model - download (if you don't have it) and put it into the \"ComfyUI\\models\\sams\" directory;\n\nUse this Node to gain the best results of the face swapping process:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_909808eb495e.jpg\" alt=\"0.5.0-whatsnew-02\" width=\"100%\"\u002F>\n\n- ReActorImageDublicator Node - rather useful for those who create videos, it helps to duplicate one image to several frames to use them with VAE Encoder (e.g. live avatars):\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d37e894a2929.jpg\" alt=\"0.5.0-whatsnew-03\" width=\"100%\"\u002F>\n\n- ReActorFaceSwapOpt (a simplified version of the Main Node) + ReActorOptions Nodes to set some additional options such as (new) \"input\u002Fsource faces separate order\". Yes! You can now set the order of faces in the index in the way you want (\"large to small\" goes by default)!\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_93993fe7e122.jpg\" alt=\"0.5.0-whatsnew-04\" width=\"100%\"\u002F>\n\n- Little speed boost when analyzing target images (unfortunately it is still quite slow in compare to swapping and restoring...)\n\n### [0.4.2](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127034727\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.2)\n\n- GPEN-BFR-512 and RestoreFormer_Plus_Plus face restoration models support\n\nYou can download models here: https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models\n\u003Cbr>Put them into the `ComfyUI\\models\\facerestore_models` folder\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6880aabd7e2f.jpg\" alt=\"0.4.2-whatsnew-04\" width=\"100%\"\u002F>\n\n- Due to popular demand - you can now blend several images with persons into one face model file and use it with \"Load Face Model\" Node or in SD WebUI as well;\n\nExperiment and create new faces or blend faces of one person to gain better accuracy and likeness!\n\nJust add the ImpactPack's \"Make Image Batch\" Node as the input to the ReActor's one and load images you want to blend into one model:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_64ca1878cd56.jpg\" alt=\"0.4.2-whatsnew-01\" width=\"100%\"\u002F>\n\nResult example (the new face was created from 4 faces of different actresses):\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_099cda5ef018.jpg\" alt=\"0.4.2-whatsnew-02\" width=\"75%\"\u002F>\n\nBasic workflow [💾](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002Fworkflows\u002FReActor--Build-Blended-Face-Model--v1.json)\n\n### [0.4.1](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127044707\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.1)\n\n- CUDA 12 Support - don't forget to run (Windows) `install.bat` or (Linux\u002FMacOS) `install.py` for ComfyUI's Python enclosure or try to install ORT-GPU for CU12 manually (https:\u002F\u002Fonnxruntime.ai\u002Fdocs\u002Finstall\u002F#install-onnx-runtime-gpu-cuda-12x)\n- Issue [comfyui-reactor-node\u002Fissues\u002F173](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20240919043728\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fissues\u002F173) fix\n\n- Separate Node for the Face Restoration postprocessing (FR [comfyui-reactor-node\u002Fissues\u002F191](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127040848\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fissues\u002F191)), can be found inside ReActor's menu (RestoreFace Node)\n- (Windows) Installation can be done for Python from the System's PATH\n- Different fixes and improvements\n\n- Face Restore Visibility and CodeFormer Weight (Fidelity) options are now available! Don't forget to reload the Node in your existing workflow\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_2dc90fc81094.jpg\" alt=\"0.4.1-whatsnew-01\" width=\"100%\"\u002F>\n\n### [0.4.0](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241119155323\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.0)\n\n- Input \"input_image\" goes first now, it gives a correct bypass and also it is right to have the main input first;\n- You can now save face models as \"safetensors\" files (`ComfyUI\\models\\reactor\\faces`) and load them into ReActor implementing different scenarios and keeping super lightweight face models of the faces you use:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_ed63446f9ab5.jpg\" alt=\"0.4.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_09e588d44bf8.jpg\" alt=\"0.4.0-whatsnew-02\" width=\"100%\"\u002F>\n\n- Ability to build and save face models directly from an image:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1b1c41aaade5.jpg\" alt=\"0.4.0-whatsnew-03\" width=\"50%\"\u002F>\n\n- Both the inputs are optional, just connect one of them according to your workflow; if both is connected - `image` has a priority.\n- Different fixes making this extension better.\n\nThanks to everyone who finds bugs, suggests new features and supports this project!\n\n\u003C\u002Fdetails>\n\n## Installation\n\n\u003Cdetails>\n\t\u003Csummary>Standalone (Portable) \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\">ComfyUI\u003C\u002Fa> for Windows\u003C\u002Fsummary>\n\n1. Do the following:\n   - Install [Visual Studio 2022](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fdownloads\u002F) (Community version - you need this step to build Insightface)\n   - OR only [VS C++ Build Tools](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fvisual-cpp-build-tools\u002F) and select \"Desktop Development with C++\" under \"Workloads -> Desktop & Mobile\"\n   - OR if you don't want to install VS or VS C++ BT - follow [this steps (sec. I)](#insightfacebuild)\n2. Choose between two options:\n   - (ComfyUI Manager) Open ComfyUI Manager, click \"Install Custom Nodes\", type \"ReActor\" in the \"Search\" field and then click \"Install\". After ComfyUI will complete the process - please restart the Server.\n   - (Manually) Go to `ComfyUI\\custom_nodes`, open Console and run `git clone https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor`\n3. Go to `ComfyUI\\custom_nodes\\ComfyUI-ReActor` and run `install.bat`\n4. If you don't have the \"face_yolov8m.pt\" Ultralytics model - you can download it from the [Assets](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt) and put it into the \"ComfyUI\\models\\ultralytics\\bbox\" directory\u003Cbr>As well as one or both of \"Sams\" models from [here](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Fsams) - download (if you don't have them) and put into the \"ComfyUI\\models\\sams\" directory\n5. Run ComfyUI and find there ReActor Nodes inside the menu `ReActor` or by using a search\n\n\u003C\u002Fdetails>\n\n## Models\n\n - buffalo_l: downloaded on first launch into `ComfyUI\\models\\insightface\\models\\buffalo_l`, or you can download manually from [here](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)\n - inswapper_128: downloaded during installation into `ComfyUI\\models\\insightface`, or you can download manually from [here](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)\n - reswapper_128\u002F256: https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels put them into `ComfyUI\\models\\reswapper`\n - hyperswap_256: https:\u002F\u002Fhuggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain (hyperswap_1a_256.onnx, hyperswap_1b_256.onnx, hyperswap_1a_256.onnx) put them into `ComfyUI\\models\\hyperswap`\n - Face restoration models: https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models put any you like into `ComfyUI\\models\\facerestore_models`\n - Ultralytics model: https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt put into `ComfyUI\\models\\ultralytics\\bbox`\n - SAM models: https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Fsams put into `ComfyUI\\models\\sams`\n\n## Usage\n\nYou can find ReActor Nodes inside the menu `ReActor` or by using a search (just type \"ReActor\" in the search field)\n\nList of Nodes:\n- ••• Main Nodes •••\n  - ReActorFaceSwap (Main Node)\n  - ReActorFaceSwapOpt (Main Node with the additional Options input)\n  - ReActorOptions (Options for ReActorFaceSwapOpt)\n  - ReActorFaceBoost (Face Booster Node)\n  - ReActorMaskHelper (Masking Helper)\n  - ReActorSetWeight (Set Face Swap Weight)\n- ••• Operations with Face Models •••\n  - ReActorSaveFaceModel (Save Face Model)\n  - ReActorLoadFaceModel (Load Face Model)\n  - ReActorBuildFaceModel (Build Blended Face Model)\n  - ReActorMakeFaceModelBatch (Make Face Model Batch)\n- ••• Additional Nodes •••\n  - ReActorRestoreFace (Face Restoration)\n  - ReActorImageDublicator (Dublicate one Image to Images List)\n  - ImageRGBA2RGB (Convert RGBA to RGB)\n  - ReActorUnload (Unload ReActor models from VRAM)\n\nConnect all required slots and run the query.\n\n### Main Node Inputs\n\n- `input_image` - is an image to be processed (target image, analog of \"target image\" in the SD WebUI extension);\n  - Supported Nodes: \"Load Image\", \"Load Video\" or any other nodes providing images as an output;\n- `source_image` - is an image with a face or faces to swap in the `input_image` (source image, analog of \"source image\" in the SD WebUI extension);\n  - Supported Nodes: \"Load Image\" or any other nodes providing images as an output;\n- `face_model` - is the input for the \"Load Face Model\" Node or another ReActor node to provide a face model file (face embedding) you created earlier via the \"Save Face Model\" Node;\n  - Supported Nodes: \"Load Face Model\", \"Build Blended Face Model\";\n- `options` - to connect ReActorOptions;\n  - Supported Nodes: \"ReActorOptions\";\n- `face_boost` - to connect ReActorFaceBoost;\n  - Supported Nodes: \"ReActorFaceBoost\";\n\n### Main Node Outputs\n\n- `IMAGE` - is an output with the resulted image;\n  - Supported Nodes: any nodes which have images as an input;\n- `FACE_MODEL` - is an output providing a source face's model being built during the swapping process;\n  - Supported Nodes: \"Save Face Model\", \"ReActor\", \"Make Face Model Batch\";\n- `ORIGINAL_IMAGE` - `input_image` bypass;\n\n### Face Restoration\n\nSince version 0.3.0 ReActor Node has a buil-in face restoration.\u003Cbr>Just download the models you want (see [Installation](#installation) instruction) and select one of them to restore the resulting face(s) during the faceswap. It will enhance face details and make your result more accurate.\n\n### Face Indexes\n\nBy default ReActor detects faces in images from \"large\" to \"small\".\u003Cbr>You can change this option by adding ReActorFaceSwapOpt node with ReActorOptions.\n\nAnd if you need to specify faces, you can set indexes for source and input images.\n\nIndex of the first detected face is 0.\n\nYou can set indexes in the order you need.\u003Cbr>\nE.g.: 0,1,2 (for Source); 1,0,2 (for Input).\u003Cbr>This means: the second Input face (index = 1) will be swapped by the first Source face (index = 0) and so on.\n\n### Genders\n\nYou can specify the gender to detect in images.\u003Cbr>\nReActor will swap a face only if it meets the given condition.\n\n### Face Models\n\nSince version 0.4.0 you can save face models as \"safetensors\" files (stored in `ComfyUI\\models\\reactor\\faces`) and load them into ReActor implementing different scenarios and keeping super lightweight face models of the faces you use.\n\nTo make new models appear in the list of the \"Load Face Model\" Node - just refresh the page of your ComfyUI web application.\u003Cbr>\n(I recommend you to use ComfyUI Manager - otherwise you workflow can be lost after you refresh the page if you didn't save it before that).\n\n### Masking Helper\n\nFace Masking feature is available since version 0.5.0, just add the \"ReActorMaskHelper\" Node to the workflow and connect it as shown below:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_52ae95901e3e.jpg\" alt=\"0.5.0-whatsnew-01\" width=\"100%\"\u002F>\n\nIf you don't have the \"face_yolov8m.pt\" Ultralytics model - you can download it from the [Assets](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt) and put it into the \"ComfyUI\\models\\ultralytics\\bbox\" directory\n\u003Cbr>\nAs well as [\"sam_vit_b_01ec64.pth\"](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fsams\u002Fsam_vit_b_01ec64.pth) or [\"sam_vit_l_0b3195.pth\"](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fsams\u002Fsam_vit_l_0b3195.pth) (better occlusion) - download (if you don't have it) and put it into the \"ComfyUI\\models\\sams\" directory;\n\nUse this Node to gain the best results of the face swapping process:\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_909808eb495e.jpg\" alt=\"0.5.0-whatsnew-02\" width=\"100%\"\u002F>\n\n### Face Swap Weigth\n\nYou can set the strength of face swap for `source_image` or `face_model` from 0% to 100% (in 12.5% step) with `ReActorSetWeight` node\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d9ce19ccd39d.jpg\" alt=\"0.6.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n## Troubleshooting\n\n\u003Ca name=\"insightfacebuild\">\n\n### **I. (For Windows users) If you still cannot build Insightface for some reasons or just don't want to install Visual Studio or VS C++ Build Tools - do the following:**\n\n1. (ComfyUI Portable) From the root folder check the version of Python:\u003Cbr>run CMD and type `python_embeded\\python.exe -V`\n2. Download prebuilt Insightface package according to Python's version you see in the previous step: [for Python 3.10](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp310-cp310-win_amd64.whl), [for Python 3.11](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp311-cp311-win_amd64.whl), [for Python 3.12](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp312-cp312-win_amd64.whl), [for Python 3.13](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp313-cp313-win_amd64.whl) - and put into ComfyUI root folder if you use ComfyUI Portable\n3. Update your PIP:\u003Cbr>\n   `python_embeded\\python.exe -m pip install -U pip`\n4. Then install Insightface:\n  \u003Cbr>(for 3.10) `python_embeded\\python.exe -m pip install insightface-0.7.3-cp310-cp310-win_amd64.whl`\n  \u003Cbr>(for 3.11) `python_embeded\\python.exe -m pip install insightface-0.7.3-cp311-cp311-win_amd64.whl`\n  \u003Cbr>(for 3.12) `python_embeded\\python.exe -m pip install insightface-0.7.3-cp312-cp312-win_amd64.whl`\n  \u003Cbr>(for 3.13) `python_embeded\\python.exe -m pip install insightface-0.7.3-cp313-cp313-win_amd64.whl` \n5. Enjoy!\n\n### **II. \"AttributeError: 'NoneType' object has no attribute 'get'\"**\n\nThis error may occur if there's smth wrong with the model file `inswapper_128.onnx`\n\nTry to download it manually from [here](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128.onnx)\nand put it to the `ComfyUI\\models\\insightface` replacing existing one\n\n### **III. \"reactor.execute() got an unexpected keyword argument 'reference_image'\"**\n\nThis means that input points have been changed with the latest update\u003Cbr>\nRemove the current ReActor Node from your workflow and add it again\n\n### **IV. ControlNet Aux Node IMPORT failed error when using with ReActor Node**\n\n1. Close ComfyUI if it runs\n2. Go to the ComfyUI root folder, open CMD there and run:\n   - `python_embeded\\python.exe -m pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless`\n   - `python_embeded\\python.exe -m pip install opencv-python==4.7.0.72`\n3. That's it!\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_fdd820855079.png\" alt=\"reactor+controlnet\" \u002F>\n\n### **V. \"ModuleNotFoundError: No module named 'basicsr'\" or \"subprocess-exited-with-error\" during future-0.18.3 installation**\n\n- Download https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002Fcomfyui-reactor-node\u002Ffuture-0.18.3-py3-none-any.whl\u003Cbr>\n- Put it to ComfyUI root And run:\n\n      python_embeded\\python.exe -m pip install future-0.18.3-py3-none-any.whl\n\n- Then:\n\n      python_embeded\\python.exe -m pip install basicsr\n\n### **VI. \"fatal: fetch-pack: invalid index-pack output\" when you try to `git clone` the repository\"**\n\nTry to clone with `--depth=1` (last commit only):\n\n     git clone --depth=1 https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\n\nThen retrieve the rest (if you need):\n\n     git fetch --unshallow\n\n## Updating\n\nJust put .bat or .sh script from this [Repo](https:\u002F\u002Fgithub.com\u002FGourieff\u002Fsd-webui-extensions-updater) to the `ComfyUI\\custom_nodes` directory and run it when you need to check for updates\n\n### Disclaimer\n\nThis software is meant to be a productive contribution to the rapidly growing AI-generated media industry. It will help artists with tasks such as animating a custom character or using the character as a model for clothing etc.\n\nThe developers of this software are aware of its possible unethical applications and are committed to take preventative measures against them. We will continue to develop this project in the positive direction while adhering to law and ethics.\n\nUsers of this software are expected to use this software responsibly while abiding the local law. If face of a real person is being used, users are suggested to get consent from the concerned person and clearly mention that it is a deepfake when posting content online. **Developers and Contributors of this software are not responsible for actions of end-users.**\n\nBy using this extension you are agree not to create any content that:\n- violates any laws;\n- causes any harm to a person or persons;\n- propagates (spreads) any information (both public or personal) or images (both public or personal) which could be meant for harm;\n- spreads misinformation;\n- targets vulnerable groups of people.\n\nThis software utilizes the pre-trained models `buffalo_l` and `inswapper_128.onnx`, which are provided by [InsightFace](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface\u002F). These models are included under the following conditions:\n\n[From insighface license](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface\u002Ftree\u002Fmaster\u002Fpython-package): The InsightFace’s pre-trained models are available for non-commercial research purposes only. This includes both auto-downloading models and manually downloaded models.\n\nUsers of this software must strictly adhere to these conditions of use. The developers and maintainers of this software are not responsible for any misuse of InsightFace’s pre-trained models.\n\nPlease note that if you intend to use this software for any commercial purposes, you will need to train your own models or find models that can be used commercially.\n\n### Models Hashsum\n\n#### Safe-to-use models have the following hash:\n\ninswapper_128.onnx\n```\nMD5:a3a155b90354160350efd66fed6b3d80\nSHA256:e4a3f08c753cb72d04e10aa0f7dbe3deebbf39567d4ead6dce08e98aa49e16af\n```\n\n1k3d68.onnx\n\n```\nMD5:6fb94fcdb0055e3638bf9158e6a108f4\nSHA256:df5c06b8a0c12e422b2ed8947b8869faa4105387f199c477af038aa01f9a45cc\n```\n\n2d106det.onnx\n\n```\nMD5:a3613ef9eb3662b4ef88eb90db1fcf26\nSHA256:f001b856447c413801ef5c42091ed0cd516fcd21f2d6b79635b1e733a7109dbf\n```\n\ndet_10g.onnx\n\n```\nMD5:4c10eef5c9e168357a16fdd580fa8371\nSHA256:5838f7fe053675b1c7a08b633df49e7af5495cee0493c7dcf6697200b85b5b91\n```\n\ngenderage.onnx\n\n```\nMD5:81c77ba87ab38163b0dec6b26f8e2af2\nSHA256:4fde69b1c810857b88c64a335084f1c3fe8f01246c9a191b48c7bb756d6652fb\n```\n\nw600k_r50.onnx\n\n```\nMD5:80248d427976241cbd1343889ed132b3\nSHA256:4c06341c33c2ca1f86781dab0e829f88ad5b64be9fba56e56bc9ebdefc619e43\n```\n\n**Please check hashsums if you download these models from unverified (or untrusted) sources**\n\n\u003Ca name=\"credits\">\n\n## Thanks and Credits\n\n\u003Cdetails>\n\t\u003Csummary>\u003Ca>Click to expand\u003C\u002Fa>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n|file|source|license|\n|----|------|-------|\n|[buffalo_l.zip](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fbuffalo_l.zip) | [DeepInsight](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [codeformer-v0.1.0.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002Fcodeformer-v0.1.0.pth) | [sczhou](https:\u002F\u002Fgithub.com\u002Fsczhou\u002FCodeFormer) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [GFPGANv1.3.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002FGFPGANv1.3.pth) | [TencentARC](https:\u002F\u002Fgithub.com\u002FTencentARC\u002FGFPGAN) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache_2.0-green.svg) |\n| [GFPGANv1.4.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002FGFPGANv1.4.pth) | [TencentARC](https:\u002F\u002Fgithub.com\u002FTencentARC\u002FGFPGAN) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache_2.0-green.svg) |\n| [inswapper_128.onnx](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128.onnx) | [DeepInsight](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [inswapper_128_fp16.onnx](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128_fp16.onnx) | [Hillobar](https:\u002F\u002Fgithub.com\u002FHillobar\u002FRope) | ![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n\n[BasicSR](https:\u002F\u002Fgithub.com\u002FXPixelGroup\u002FBasicSR) - [@XPixelGroup](https:\u002F\u002Fgithub.com\u002FXPixelGroup) \u003Cbr>\n[facexlib](https:\u002F\u002Fgithub.com\u002Fxinntao\u002Ffacexlib) - [@xinntao](https:\u002F\u002Fgithub.com\u002Fxinntao) \u003Cbr>\n\n[@s0md3v](https:\u002F\u002Fgithub.com\u002Fs0md3v), [@henryruhs](https:\u002F\u002Fgithub.com\u002Fhenryruhs) - the original Roop App \u003Cbr>\n[@ssitu](https:\u002F\u002Fgithub.com\u002Fssitu) - the first version of [ComfyUI_roop](https:\u002F\u002Fgithub.com\u002Fssitu\u002FComfyUI_roop) extension\n\n\u003C\u002Fdetails>\n\n\u003Ca name=\"note\">\n\n### Note!\n\n**If you encounter any errors when you use ReActor Node - don't rush to open an issue, first try to remove current ReActor node in your workflow and add it again**\n\n**ReActor Node gets updates from time to time, new functions appear and old node can work with errors or not work at all**\n","\u003Cdiv align=\"center\">\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d20593fd3647.png\" alt=\"logo\" width=\"180px\"\u002F>\n\n  ![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode_version-0.6.2_beta1-green?style=for-the-badge&labelColor=darkgreen)\n\n  \u003C!--\u003Csup>\n  \u003Cfont color=brightred>\n\n  ## !!! [重要更新 ]( #latestupdate ) !!!\u003Cbr>请别忘了在现有工作流中重新添加该节点\n  \n  \u003C\u002Ffont>\n  \u003C\u002Fsup>-->\n  \n  \u003Ca href=\"https:\u002F\u002Fboosty.to\u002Fartgourieff\" target=\"_blank\">\n    \u003Cimg src=\"https:\u002F\u002Flovemet.ru\u002Fimg\u002Fboosty.jpg\" width=\"108\" alt=\"在Boosty上支持我\"\u002F>\n    \u003Cbr>\n    \u003Csup>\n      支持本项目\n    \u003C\u002Fsup>\n  \u003C\u002Fa>\n\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Freactor_faceswap\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReActor-2CA5E0?style=for-the-badge&logo=Telegram&logoColor=white&labelColor=blue\">\u003C\u002Fimg>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ft.me\u002Fartgourieff\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FArtGourieff-2CA5E0?style=for-the-badge&logo=Telegram&logoColor=white&labelColor=blue\">\u003C\u002Fimg>\u003C\u002Fa>\n\n  \u003Chr>\n  \n  [![提交活跃度](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Ft\u002FGourieff\u002FComfyUI-ReActor\u002Fmain?cacheSeconds=0)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fcommits\u002Fmain)\n  ![最近一次提交](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FGourieff\u002FComfyUI-ReActor\u002Fmain?cacheSeconds=0)\n  [![已打开的问题](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FGourieff\u002FComfyUI-ReActor?color=red)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues?cacheSeconds=0)\n  [![已关闭的问题](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-closed\u002FGourieff\u002FComfyUI-ReActor?color=green&cacheSeconds=0)](https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues?q=is%3Aissue+state%3Aclosed)\n  ![许可证](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FGourieff\u002FComfyUI-ReActor)\n\n  英文 | [俄文](\u002FREADME_RU.md)\n\n# ComfyUI 的 ReActor 节点\u003Cbr>\u003Csub>\u003Csup>-=适合所有年龄段=-\u003C\u002Fsup>\u003C\u002Fsub>\n\n\u003C\u002Fdiv>\n\n### 基于[被封禁的 ReActor](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241230084620\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node)的快速简单人脸替换扩展节点——现在内置了色情内容检测器，以避免将此软件用于含有成人内容的场景。\n\n> 使用本节点即表示您已接受并承担[免责声明](#disclaimer)\n\n\u003Cdiv align=\"center\">\n\n---\n[**最新动态**](#latestupdate) | [**安装**](#installation) | [**使用方法**](#usage) | [**故障排除**](#troubleshooting) | [**更新说明**](#updating) | [**免责声明**](#disclaimer) | [**致谢**](#credits) | [**注意！**](#note)\n\n---\n\n\u003C\u002Fdiv>\n\n\u003Ca name=\"latestupdate\">\n\n## 最新更新内容\n\n### 0.6.2 \u003Csub>\u003Csup>BETA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- 新增对 FaceFusion Labs 的 HyperSwap 模型的支持（感谢 [@Buumcode](https:\u002F\u002Fgithub.com\u002FBuumcode) 的贡献）\u003Cbr>您可以从这里下载：\u003Cbr>[huggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain](https:\u002F\u002Fhuggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain)\u003Cbr>文件包括：hyperswap_1a_256.onnx、hyperswap_1b_256.onnx 和 hyperswap_1c_256.onnx。\u003Cbr>请将其放入 `ComfyUI\\models\\hyperswap` 目录中。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_dc06ad600d45.jpg\" alt=\"0.6.2-whatsnew-04-3\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\nInswapper、Reswapper 和 HyperSwap 的对比图：\u003Cbr>[github.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.2_swapmodels_compare.png](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.2_swapmodels_compare.png)\n\n- 修复与改进\n\n### 0.6.2 \u003Csub>\u003Csup>ALPHA2、ALPHA3、ALPHA4\u003C\u002Fsup>\u003C\u002Fsub>\n\n- 一些小但重要的修复\n\n### 0.6.2 \u003Csub>\u003Csup>ALPHA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- 【实验性功能】终于实现了！面部修复过程仅作用于被替换的人脸。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_add262011c0a.jpg\" alt=\"0.6.2-whatsnew-01\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n- 【实验性功能】新增“高级面部修复”节点，配备面部修复滤镜。感谢 @Buumcode 实现了“面部修复滤镜”。\u003Cbr>此节点可帮助您对指定的脸部应用修复处理。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6c876c0fb5d8.jpg\" alt=\"0.6.2-whatsnew-02\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n- 为“加载人脸模型”节点新增 FACE_MODEL_NAME 输出。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1da9a8723b94.jpg\" alt=\"0.6.2-whatsnew-03\" width=\"50%\"\u002F>\n\u003C\u002Fcenter>\n\n### 0.6.1\n\n- 改进了多张人脸和多个索引下的性别检测逻辑。\n- MaskHelper 节点速度提升至原来的两倍——虽未完全完美，但相比之前快了1.5到2倍。\n- 为不同步骤引入了 ComfyUI 原生进度条。\n- 主要节点新增 ORIGINAL_IMAGE 输出。\n- 其他修复与改进（例如修复 GitHub 问题 #25；移除了 NSFW 检测器的临时文件；NSFW 检测器速度略有提升）。\n\n### 0.6.0\n\n- 新增节点 `ReActorSetWeight`——现在您可以为 `source_image` 或 `face_model` 设置 0% 至 100% 的人脸替换强度，步长为 12.5%。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d9ce19ccd39d.jpg\" alt=\"0.6.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_773f01a76317.jpg\" alt=\"0.6.0-whatsnew-02\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6b18ef5700a7.gif\" alt=\"0.6.0-whatsnew-03\" width=\"540px\"\u002F>\n\u003C\u002Fcenter>\n\n\u003Cdetails>\n\t\u003Csummary>\u003Ca>历史版本\u003C\u002Fa>\u003C\u002Fsummary>\n\n### 0.5.2\n\n- 支持 ReSwapper 模型。尽管 Inswapper 仍具有最佳相似度，但 ReSwapper 正在不断发展——感谢 @somanchiu 及其 ReSwapper 项目！这对社区来说是创建 Inswapper 替代方案的重要一步！\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_2441dbaf33a9.jpg\" alt=\"0.5.2-whatsnew-03\" width=\"75%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_39e7690e261c.jpg\" alt=\"0.5.2-whatsnew-04\" width=\"75%\"\u002F>\n\u003C\u002Fcenter>\n\n您可在此下载 ReSwapper 模型：\u003Cbr>[huggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)\u003Cbr>只需将其放入 “models\u002Freswapper” 目录即可。\n\n- 引入 NSFW 检测器，以遵守 [GitHub 规则](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fsite-policy\u002Facceptable-use-policies\u002Fgithub-misinformation-and-disinformation#synthetic--manipulated-media-tools)。\n- 新增“卸载 ReActor 模型”节点——在复杂工作流中，当需要释放 ReActor 占用的显存时非常有用。\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_0b020fbf791a.jpg\" alt=\"0.5.2-whatsnew-01\" width=\"100%\"\u002F>\n\n- 支持 ORT CoreML 和 ROCM EP，只需安装所需的 onnxruntime 版本。\n- 安装脚本优化，可自动安装最新版本的 ORT-GPU。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_8430f433ad21.jpg\" alt=\"0.5.2-whatsnew-02\" width=\"50%\"\u002F>\n\u003C\u002Fcenter>\n\n- 修复与改进\n\n### 0.5.1\n\n- 支持 GPEN 1024\u002F2048 恢复模型（可在 HF 数据集 https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models 中找到）\n- ReActorFaceBoost 节点——旨在提升换脸后的画质。其核心思想是在将换脸结果贴合到目标图像之前（通过 inswapper 算法），先对换脸区域进行修复并按恢复模型的 `face_size` 参数进行缩放。更多信息请参见 [这里（PR#321）](https:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fpull\u002F321)。\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1db26f9f73ab.jpg\" alt=\"0.5.1-whatsnew-01\" width=\"100%\"\u002F>\n\n[完整尺寸演示预览](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.1-whatsnew-02.png)\n\n- 按字母顺序对人脸模型进行排序\n- 大量修复与改进\n\n### [0.5.0 \u003Csub>\u003Csup>BETA4\u003C\u002Fsup>\u003C\u002Fsub>](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127121952\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.5.0)\n\n- 支持 GFPGAN 的 Spandrel 库\n\n### 0.5.0 \u003Csub>\u003Csup>BETA3\u003C\u002Fsup>\u003C\u002Fsub>\n\n- 修复了“内存问题”和 MaskingHelper 的“未检测到”问题。\n\n### 0.5.0 \u003Csub>\u003Csup>BETA2\u003C\u002Fsup>\u003C\u002Fsub>\n\n- 现在可以从已有的多个人脸模型中构建一个混合人脸模型。只需在工作流中添加“Make Face Model Batch”节点，并通过“Load Face Model”连接多个模型即可。\n- 图像分析模块性能大幅提升！速度提升了10倍！现在处理视频变得非常流畅！\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_9c8bf8bab69c.png\" alt=\"0.5.0-whatsnew-05\" width=\"100%\"\u002F>\n\n### 0.5.0 \u003Csub>\u003Csup>BETA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- Masking Helper 节点新增 SWAPPED_FACE 输出\n- 修复：移除了 Masking Helper IMAGE 输出中的空 A 通道（该问题会导致某些节点报错）。\n\n### 0.5.0 \u003Csub>\u003Csup>ALPHA1\u003C\u002Fsup>\u003C\u002Fsub>\n\n- ReActorBuildFaceModel 节点新增 “face_model” 输出，可直接为主节点提供混合人脸模型：\n\n基础工作流 [💾](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002Fworkflows\u002FReActor--Build-Blended-Face-Model--v2.json)\n\n- 现已支持人脸遮罩功能。只需在工作流中添加“ReActorMaskHelper”节点，并按如下方式连接：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_52ae95901e3e.jpg\" alt=\"0.5.0-whatsnew-01\" width=\"100%\"\u002F>\n\n如果您没有 Ultralytics 的 “face_yolov8m.pt” 模型，可以从 [Assets](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt) 下载，并将其放置在 “ComfyUI\\models\\ultralytics\\bbox” 目录下；\n同样地，“sam_vit_b_01ec64.pth” 模型也可下载（如尚未拥有），并放入 “ComfyUI\\models\\sams” 目录中。\n\n使用此节点可以获得最佳的换脸效果：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_909808eb495e.jpg\" alt=\"0.5.0-whatsnew-02\" width=\"100%\"\u002F>\n\n- ReActorImageDublicator 节点——对于制作视频的用户非常实用。它可以帮助将一张图片复制到多个帧上，以便与 VAE 编码器配合使用（例如用于实时头像）：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d37e894a2929.jpg\" alt=\"0.5.0-whatsnew-03\" width=\"100%\"\u002F>\n\n- ReActorFaceSwapOpt（主节点的简化版本）+ ReActorOptions 节点，用于设置一些附加选项，例如（新增）“输入\u002F源人脸的单独顺序”。是的！现在您可以按照自己想要的方式设置索引中人脸的顺序（默认为“从大到小”）！\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_93993fe7e122.jpg\" alt=\"0.5.0-whatsnew-04\" width=\"100%\"\u002F>\n\n- 在分析目标图像时略有提速（不过相比换脸和修复过程，速度仍然较慢……）\n\n### [0.4.2](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127034727\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.2)\n\n- 支持 GPEN-BFR-512 和 RestoreFormer_Plus_Plus 人脸修复模型\n您可以在以下链接下载这些模型：https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models\n然后将它们放入 `ComfyUI\\models\\facerestore_models` 文件夹中。\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_6880aabd7e2f.jpg\" alt=\"0.4.2-whatsnew-04\" width=\"100%\"\u002F>\n\n- 因应广泛需求，现在可以将多张包含人物的图片混合成一个单一的人脸模型文件，并将其用于“Load Face Model”节点或 SD WebUI 中；\n尽情尝试创建新面孔，或将同一个人的不同面部特征混合，以获得更高的准确性和相似度！\n\n只需将 ImpactPack 的“Make Image Batch”节点作为输入连接到 ReActor 节点，并加载您希望混合成一个模型的图片即可：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_64ca1878cd56.jpg\" alt=\"0.4.2-whatsnew-01\" width=\"100%\"\u002F>\n\n结果示例（新面孔由四位不同女演员的面部特征混合而成）：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_099cda5ef018.jpg\" alt=\"0.4.2-whatsnew-02\" width=\"75%\"\u002F>\n\n基础工作流 [💾](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002Fworkflows\u002FReActor--Build-Blended-Face-Model--v1.json)\n\n### [0.4.1](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127044707\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.1)\n\n- 支持 CUDA 12——请务必运行 Windows 版本的 `install.bat` 或 Linux\u002FMacOS 版本的 `install.py` 来安装 ComfyUI 的 Python 环境；或者手动为 CU12 安装 ORT-GPU（https:\u002F\u002Fonnxruntime.ai\u002Fdocs\u002Finstall\u002F#install-onnx-runtime-gpu-cuda-12x）。\n- 修复了 issue [comfyui-reactor-node\u002Fissues\u002F173](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20240919043728\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fissues\u002F173)。\n- 新增专门用于人脸修复后处理的节点（FR [comfyui-reactor-node\u002Fissues\u002F191](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241127040848\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Fissues\u002F191)），可在 ReActor 菜单中找到（RestoreFace 节点）。\n- Windows 系统下，Python 可直接从系统 PATH 进行安装。\n- 其他多项修复与改进。\n\n- 现已提供人脸修复可见性及 CodeFormer 权重（保真度）选项！请别忘了在现有工作流中重新加载该节点。\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_2dc90fc81094.jpg\" alt=\"0.4.1-whatsnew-01\" width=\"100%\"\u002F>\n\n### [0.4.0](https:\u002F\u002Fweb.archive.org\u002Fweb\u002F20241119155323\u002Fhttps:\u002F\u002Fgithub.com\u002FGourieff\u002Fcomfyui-reactor-node\u002Freleases\u002Ftag\u002Fv0.4.0)\n\n- 现在“input_image”输入端口排在首位，这样可以正确绕过，并且将主输入放在前面也是合理的；\n- 您现在可以将人脸模型保存为“safetensors”文件（`ComfyUI\\models\\reactor\\faces`），并将其加载到ReActor中，以实现不同的场景需求，同时保持所用面孔的超轻量级模型：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_ed63446f9ab5.jpg\" alt=\"0.4.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_09e588d44bf8.jpg\" alt=\"0.4.0-whatsnew-02\" width=\"100%\"\u002F>\n\n- 现在可以直接从一张图片构建并保存人脸模型：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_1b1c41aaade5.jpg\" alt=\"0.4.0-whatsnew-03\" width=\"50%\"\u002F>\n\n- 这两个输入都是可选的，您可以根据工作流只连接其中一个；如果两个都已连接，则“image”具有优先权。\n- 其他多项修复使此扩展更加完善。\n\n感谢所有发现错误、提出新功能建议以及支持本项目的朋友！\n\n\u003C\u002Fdetails>\n\n## 安装\n\n\u003Cdetails>\n\t\u003Csummary>适用于Windows的独立（便携式）\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\">ComfyUI\u003C\u002Fa>\u003C\u002Fsummary>\n\n1. 请执行以下操作：\n   - 安装[Visual Studio 2022](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fdownloads\u002F)（社区版——您需要此步骤来构建Insightface）\n   - 或仅安装[VS C++ 构建工具](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fvisual-cpp-build-tools\u002F)，并在“工作负载 -> 桌面与移动开发”中选择“使用 C++ 的桌面开发”\n   - 或者，如果您不想安装 VS 或 VS C++ 构建工具，请按照[此处步骤（第 I 部分）](#insightfacebuild)进行操作\n2. 您可以选择以下两种方式之一：\n   - （ComfyUI 管理器）打开 ComfyUI 管理器，点击“安装自定义节点”，在“搜索”栏中输入“ReActor”，然后点击“安装”。ComfyUI 完成安装后，请重启服务器。\n   - （手动）进入 `ComfyUI\\custom_nodes`，打开控制台并运行 `git clone https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor`\n3. 进入 `ComfyUI\\custom_nodes\\ComfyUI-ReActor` 并运行 `install.bat`\n4. 如果您还没有 Ultralytics 的“face_yolov8m.pt”模型，可以从[资源库](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt)下载，并将其放入 `ComfyUI\\models\\ultralytics\\bbox` 目录。\u003Cbr>同样，您也可以从[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Fsams)下载 Sams 模型中的一个或两个——如果尚未拥有，则下载后放入 `ComfyUI\\models\\sams` 目录。\n5. 启动 ComfyUI，在菜单 `ReActor` 中或通过搜索找到 ReActor 节点。\n\n\u003C\u002Fdetails>\n\n## 模型\n\n - buffalo_l：首次启动时会自动下载到 `ComfyUI\\models\\insightface\\models\\buffalo_l`，您也可以从[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)手动下载。\n - inswapper_128：安装过程中会自动下载到 `ComfyUI\\models\\insightface`，您也可以从[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)手动下载。\n - reswapper_128\u002F256：来自[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels)，请将其放入 `ComfyUI\\models\\reswapper`。\n - hyperswap_256：来自[这里](https:\u002F\u002Fhuggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain)（hyperswap_1a_256.onnx、hyperswap_1b_256.onnx、hyperswap_1a_256.onnx），请将其放入 `ComfyUI\\models\\hyperswap`。\n - 人脸修复模型：来自[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Ffacerestore_models)，您可以将任何喜欢的模型放入 `ComfyUI\\models\\facerestore_models`。\n - Ultralytics 模型：来自[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt)，请将其放入 `ComfyUI\\models\\ultralytics\\bbox`。\n - SAM 模型：来自[这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\u002Fsams)，请将其放入 `ComfyUI\\models\\sams`。\n\n## 使用方法\n\n您可以在菜单 `ReActor` 中或通过搜索找到 ReActor 节点（只需在搜索栏中输入“ReActor”即可）。\n\n节点列表：\n- ••• 主要节点 •••\n  - ReActorFaceSwap（主节点）\n  - ReActorFaceSwapOpt（带有附加选项输入的主节点）\n  - ReActorOptions（ReActorFaceSwapOpt 的选项节点）\n  - ReActorFaceBoost（面部增强节点）\n  - ReActorMaskHelper（遮罩辅助节点）\n  - ReActorSetWeight（设置换脸权重）\n- ••• 人脸模型相关操作 •••\n  - ReActorSaveFaceModel（保存人脸模型）\n  - ReActorLoadFaceModel（加载人脸模型）\n  - ReActorBuildFaceModel（构建混合人脸模型）\n  - ReActorMakeFaceModelBatch（批量制作人脸模型）\n- ••• 其他节点 •••\n  - ReActorRestoreFace（面部修复）\n  - ReActorImageDublicator（将单张图像复制到图像列表）\n  - ImageRGBA2RGB（将 RGBA 转换为 RGB）\n  - ReActorUnload（从显存中卸载 ReActor 模型）\n\n连接所有必要的插槽并运行查询。\n\n### 主节点输入\n\n- `input_image` —— 是待处理的图像（目标图像，类似于 SD WebUI 扩展中的“target image”）；\n  - 支持的节点： “Load Image”、“Load Video”或其他输出图像的节点；\n- `source_image` —— 是包含要交换到 `input_image` 中的人脸的图像（源图像，类似于 SD WebUI 扩展中的“source image”）；\n  - 支持的节点： “Load Image”或其他输出图像的节点；\n- `face_model` —— 是用于“Load Face Model”节点或其他 ReActor 节点的输入，提供您之前通过“Save Face Model”节点创建的人脸模型文件（人脸嵌入）；\n  - 支持的节点： “Load Face Model”、“Build Blended Face Model”；\n- `options` —— 用于连接 ReActorOptions；\n  - 支持的节点： “ReActorOptions”；\n- `face_boost` —— 用于连接 ReActorFaceBoost；\n  - 支持的节点： “ReActorFaceBoost”。\n\n### 主节点输出\n\n- `IMAGE` —— 是最终生成的图像输出；\n  - 支持的节点：任何接受图像作为输入的节点；\n- `FACE_MODEL` —— 是在换脸过程中构建的源人脸模型输出；\n  - 支持的节点： “Save Face Model”、“ReActor”、“Make Face Model Batch”；\n- `ORIGINAL_IMAGE` —— 是 `input_image` 的旁路输出。\n\n### 人脸修复\n\n自 0.3.0 版本起，ReActor 节点内置了人脸修复功能。\u003Cbr>只需下载您想要的模型（参见[安装说明](#installation)），并在换脸过程中选择其中一种来修复生成的人脸。这将增强面部细节，使您的结果更加精确。\n\n### 人脸索引\n\n默认情况下，ReActor 会从“大”到“小”检测图像中的所有人脸。\u003Cbr>您可以通过添加带有 ReActorOptions 的 ReActorFaceSwapOpt 节点来更改此选项。\n\n如果您需要指定特定的人脸，可以为源图像和输入图像设置索引。\n\n第一个检测到的人脸索引为 0。\n\n您可以按照所需的顺序设置索引。\u003Cbr>\n例如：源图像为 0,1,2；输入图像为 1,0,2。\u003Cbr>这意味着：第二个输入图像的人脸（索引 = 1）将被第一个源图像的人脸（索引 = 0）替换，以此类推。\n\n### 性别\n\n您可以指定在图像中要检测的性别。\u003Cbr>ReActor 只有在人脸符合给定条件时才会进行交换。\n\n### 人脸模型\n\n自 0.4.0 版本起，您可以将人脸模型保存为 “safetensors” 文件（存储在 `ComfyUI\\models\\reactor\\faces` 目录下），并将其加载到 ReActor 中，以实现不同的场景需求，同时保持所用人脸模型的轻量化。\n\n要使新模型出现在“加载人脸模型”节点的列表中，请刷新您的 ComfyUI Web 应用程序页面。\u003Cbr>\n（建议您使用 ComfyUI Manager——否则，如果您未提前保存工作流，在刷新页面后可能会丢失工作流。）\n\n### 掩码辅助工具\n\n自 0.5.0 版本起，面部掩码功能可用。只需将“ReActorMaskHelper”节点添加到工作流中，并按如下所示连接：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_52ae95901e3e.jpg\" alt=\"0.5.0-whatsnew-01\" width=\"100%\"\u002F>\n\n如果您没有 Ultralytics 的 “face_yolov8m.pt” 模型，可以从 [Assets](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fdetection\u002Fbbox\u002Fface_yolov8m.pt) 下载，并将其放入 “ComfyUI\\models\\ultralytics\\bbox” 目录中。\n\n此外，还可以下载 [“sam_vit_b_01ec64.pth”](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fsams\u002Fsam_vit_b_01ec64.pth) 或 [“sam_vit_l_0b3195.pth”](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fsams\u002Fsam_vit_l_0b3195.pth)（遮挡效果更好），如果尚未拥有，则下载后放入 “ComfyUI\\models\\sams” 目录中。\n\n使用此节点可以获得最佳的人脸交换效果：\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_909808eb495e.jpg\" alt=\"0.5.0-whatsnew-02\" width=\"100%\"\u002F>\n\n### 人脸交换权重\n\n您可以通过 ReActorSetWeight 节点，将 `source_image` 或 `face_model` 的人脸交换强度设置为 0% 至 100%，步长为 12.5%。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_d9ce19ccd39d.jpg\" alt=\"0.6.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003C\u002Fcenter>\n\n## 故障排除\n\n\u003Ca name=\"insightfacebuild\">\n\n### **I. （Windows 用户）如果您仍然无法构建 Insightface，或者只是不想安装 Visual Studio 或 VS C++ Build Tools，请执行以下操作：**\n\n1. （ComfyUI Portable）从根目录检查 Python 版本：\u003Cbr>打开 CMD 并输入 `python_embeded\\python.exe -V`\n2. 根据上一步显示的 Python 版本下载预编译的 Insightface 包：[适用于 Python 3.10](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp310-cp310-win_amd64.whl)，[适用于 Python 3.11](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp311-cp311-win_amd64.whl)，[适用于 Python 3.12](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp312-cp312-win_amd64.whl)，[适用于 Python 3.13](https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002FInsightface\u002Finsightface-0.7.3-cp313-cp313-win_amd64.whl)——并将它们放入 ComfyUI Portable 的根目录。\n3. 更新您的 PIP：\u003Cbr>\n   `python_embeded\\python.exe -m pip install -U pip`\n4. 然后安装 Insightface：\n  \u003Cbr>（适用于 3.10）`python_embeded\\python.exe -m pip install insightface-0.7.3-cp310-cp310-win_amd64.whl`\n  \u003Cbr>（适用于 3.11）`python_embeded\\python.exe -m pip install insightface-0.7.3-cp311-cp311-win_amd64.whl`\n  \u003Cbr>（适用于 3.12）`python_embeded\\python.exe -m pip install insightface-0.7.3-cp312-cp312-win_amd64.whl`\n  \u003Cbr>（适用于 3.13）`python_embeded\\python.exe -m pip install insightface-0.7.3-cp313-cp313-win_amd64.whl`\n5. 大功告成！\n\n### **II. “AttributeError: 'NoneType' 对象没有属性 'get'”**\n\n此错误可能发生在模型文件 `inswapper_128.onnx` 出现问题时。\n\n请尝试从 [这里](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128.onnx) 手动下载该文件，并将其放置在 `ComfyUI\\models\\insightface` 目录中，替换现有的文件。\n\n### **III. “reactor.execute() 获取了意外的关键字参数 'reference_image'”**\n\n这表明输入点已在最新更新中发生变化。\u003Cbr>请从您的工作流中移除当前的 ReActor 节点，然后重新添加。\n\n### **IV. 使用 ReActor 节点时 ControlNet Aux 节点导入失败错误**\n\n1. 如果 ComfyUI 正在运行，请先关闭它。\n2. 进入 ComfyUI 根目录，在 CMD 中运行：\n   - `python_embeded\\python.exe -m pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless`\n   - `python_embeded\\python.exe -m pip install opencv-python==4.7.0.72`\n3. 完成！\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_readme_fdd820855079.png\" alt=\"reactor+controlnet\" \u002F>\n\n### **V. 在安装 future-0.18.3 时出现 “ModuleNotFoundError: 没有名为 'basicsr' 的模块” 或 “subprocess-exited-with-error” 错误**\n\n- 下载 https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fraw\u002Fmain\u002Fcomfyui-reactor-node\u002Ffuture-0.18.3-py3-none-any.whl\u003Cbr>\n- 将其放入 ComfyUI 根目录并运行：\n\n      python_embeded\\python.exe -m pip install future-0.18.3-py3-none-any.whl\n\n- 然后：\n\n      python_embeded\\python.exe -m pip install basicsr\n\n### **VI. “fatal: fetch-pack: invalid index-pack output” 当您尝试 `git clone` 仓库时**\n\n请尝试使用 `--depth=1`（仅克隆最近一次提交）进行克隆：\n\n     git clone --depth=1 https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\n\n如果需要获取其余内容，可以运行：\n\n     git fetch --unshallow\n\n## 更新\n\n只需将此 [Repo](https:\u002F\u002Fgithub.com\u002FGourieff\u002Fsd-webui-extensions-updater) 中的 .bat 或 .sh 脚本放入 `ComfyUI\\custom_nodes` 目录，并在需要检查更新时运行即可。\n\n### 免责声明\n\n本软件旨在为快速发展的AI生成媒体行业做出积极贡献。它将帮助艺术家完成诸如为自定义角色制作动画，或将该角色用作服装模特等任务。\n\n本软件的开发者深知其可能存在的不道德用途，并致力于采取预防措施加以防范。我们将继续秉持合法合规与伦理道德的原则，推动该项目向积极方向发展。\n\n使用本软件的用户应遵守当地法律法规，负责任地使用本软件。若使用真实人物的面部信息，建议事先征得当事人同意，并在在线发布内容时明确标注为深度伪造内容。**本软件的开发者及贡献者对最终用户的任何行为不承担任何责任。**\n\n通过使用本扩展程序，您承诺不会创建任何以下内容：\n- 违反任何法律的内容；\n- 对个人或多人造成伤害的内容；\n- 传播（散布）任何可能用于伤害他人的信息（无论是公开的还是私人的）或图像（无论是公开的还是私人的）；\n- 散布虚假信息；\n- 针对弱势群体的内容。\n\n本软件使用了由[InsightFace](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface\u002F)提供的预训练模型`buffalo_l`和`inswapper_128.onnx`。这些模型的使用受以下条件约束：\n\n[摘自InsightFace许可协议](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface\u002Ftree\u002Fmaster\u002Fpython-package)：InsightFace的预训练模型仅可用于非商业性的研究目的。这包括自动下载的模型以及手动下载的模型。\n\n使用本软件的用户必须严格遵守上述使用条件。本软件的开发者和维护者对InsightFace预训练模型的任何滥用行为不承担任何责任。\n\n请注意，如果您打算将本软件用于任何商业目的，您需要自行训练模型，或寻找可用于商业用途的模型。\n\n### 模型哈希值\n\n#### 可安全使用的模型具有以下哈希值：\n\ninswapper_128.onnx\n```\nMD5:a3a155b90354160350efd66fed6b3d80\nSHA256:e4a3f08c753cb72d04e10aa0f7dbe3deebbf39567d4ead6dce08e98aa49e16af\n```\n\n1k3d68.onnx\n\n```\nMD5:6fb94fcdb0055e3638bf9158e6a108f4\nSHA256:df5c06b8a0c12e422b2ed8947b8869faa4105387f199c477af038aa01f9a45cc\n```\n\n2d106det.onnx\n\n```\nMD5:a3613ef9eb3662b4ef88eb90db1fcf26\nSHA256:f001b856447c413801ef5c42091ed0cd516fcd21f2d6b79635b1e733a7109dbf\n```\n\ndet_10g.onnx\n\n```\nMD5:4c10eef5c9e168357a16fdd580fa8371\nSHA256:5838f7fe053675b1c7a08b633df49e7af5495cee0493c7dcf6697200b85b5b91\n```\n\ngenderage.onnx\n\n```\nMD5:81c77ba87ab38163b0dec6b26f8e2af2\nSHA256:4fde69b1c810857b88c64a335084f1c3fe8f01246c9a191b48c7bb756d6652fb\n```\n\nw600k_r50.onnx\n\n```\nMD5:80248d427976241cbd1343889ed132b3\nSHA256:4c06341c33c2ca1f86781dab0e829f88ad5b64be9fba56e56bc9ebdefc619e43\n```\n\n**请务必检查从未经验证（或不可信）来源下载的这些模型的哈希值是否匹配。**\n\n\u003Ca name=\"credits\">\n\n## 致谢与鸣谢\n\n\u003Cdetails>\n\t\u003Csummary>\u003Ca>点击展开\u003C\u002Fa>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n|文件|来源|许可证|\n|----|------|-------|\n|[buffalo_l.zip](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Fbuffalo_l.zip) | [DeepInsight](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [codeformer-v0.1.0.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002Fcodeformer-v0.1.0.pth) | [sczhou](https:\u002F\u002Fgithub.com\u002Fsczhou\u002FCodeFormer) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [GFPGANv1.3.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002FGFPGANv1.3.pth) | [TencentARC](https:\u002F\u002Fgithub.com\u002FTencentARC\u002FGFPGAN) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache_2.0-green.svg) |\n| [GFPGANv1.4.pth](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fblob\u002Fmain\u002Fmodels\u002Ffacerestore_models\u002FGFPGANv1.4.pth) | [TencentARC](https:\u002F\u002Fgithub.com\u002FTencentARC\u002FGFPGAN) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache_2.0-green.svg) |\n| [inswapper_128.onnx](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128.onnx) | [DeepInsight](https:\u002F\u002Fgithub.com\u002Fdeepinsight\u002Finsightface) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n| [inswapper_128_fp16.onnx](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Fresolve\u002Fmain\u002Fmodels\u002Finswapper_128_fp16.onnx) | [Hillobar](https:\u002F\u002Fgithub.com\u002FHillobar\u002FRope) | ![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-non_commercial-red) |\n\n[BasicSR](https:\u002F\u002Fgithub.com\u002FXPixelGroup\u002FBasicSR) - [@XPixelGroup](https:\u002F\u002Fgithub.com\u002FXPixelGroup) \u003Cbr>\n[facexlib](https:\u002F\u002Fgithub.com\u002Fxinntao\u002Ffacexlib) - [@xinntao](https:\u002F\u002Fgithub.com\u002Fxinntao) \u003Cbr>\n\n[@s0md3v](https:\u002F\u002Fgithub.com\u002Fs0md3v), [@henryruhs](https:\u002F\u002Fgithub.com\u002Fhenryruhs) - 原始Roop应用 \u003Cbr>\n[@ssitu](https:\u002F\u002Fgithub.com\u002Fssitu) - [ComfyUI_roop](https:\u002F\u002Fgithub.com\u002Fssitu\u002FComfyUI_roop)扩展的第一个版本\n\n\u003C\u002Fdetails>\n\n\u003Ca name=\"note\">\n\n### 注意！\n\n**如果您在使用ReActor节点时遇到任何问题，请不要急于提交问题，而是先尝试从您的工作流中移除当前的ReActor节点，然后重新添加一次。**\n\n**ReActor节点会不定期更新，可能会新增功能，也可能导致旧版节点出现错误甚至无法正常运行。**","# ComfyUI-ReActor 快速上手指南\n\nComfyUI-ReActor 是一个专为 ComfyUI 设计的高效换脸节点扩展，基于 ReActor 项目构建。它支持多种换脸模型（Inswapper, ReSwapper, HyperSwap），内置色情内容检测机制以确保合规，并提供高级面部修复和遮罩功能。\n\n## 环境准备\n\n### 系统要求\n- **操作系统**: Windows 10\u002F11, Linux, macOS\n- **Python**: 3.10 或更高版本（推荐与 ComfyUI 环境一致）\n- **GPU**: 推荐使用 NVIDIA GPU (CUDA 支持) 以获得最佳性能；也支持 ROCm (AMD) 和 CoreML (macOS)\n- **显存**: 建议 4GB 以上，处理高分辨率或视频时建议 8GB+\n\n### 前置依赖\nComfyUI-ReActor 依赖以下运行时库，安装脚本通常会自动处理，但需确保网络通畅：\n- `onnxruntime-gpu` (NVIDIA) \u002F `onnxruntime-rocm` (AMD) \u002F `onnxruntime-silicon` (Mac)\n- `insightface`\n- `opencv-python`\n- `torch` (需与 ComfyUI 版本兼容)\n\n> **国内加速建议**：若下载模型或依赖受阻，建议配置 pip 国内镜像源（如清华源、阿里源）或使用代理工具。部分模型文件可通过国内镜像站下载后手动放置。\n\n## 安装步骤\n\n### 方法一：通过 ComfyUI Manager 安装（推荐）\n1. 确保已安装 **ComfyUI Manager**。\n2. 启动 ComfyUI，点击右侧菜单的 **\"Manager\"** 按钮。\n3. 选择 **\"Install Custom Nodes\"**。\n4. 在搜索框输入 `ReActor` 或 `ComfyUI-ReActor`。\n5. 找到 `ComfyUI-ReActor` (作者：Gourieff)，点击 **Install**。\n6. 安装完成后重启 ComfyUI。\n\n### 方法二：手动克隆安装\n在 `ComfyUI\u002Fcustom_nodes` 目录下执行以下命令：\n\n```bash\ncd ComfyUI\u002Fcustom_nodes\ngit clone https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor.git\n```\n\n安装依赖（进入插件目录）：\n```bash\ncd ComfyUI-ReActor\npip install -r requirements.txt\n```\n*注：若使用国内网络，建议使用国内 pip 源：*\n```bash\npip install -r requirements.txt -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 下载必要模型\n首次运行时，插件会自动下载基础模型。若自动下载失败，可手动下载以下模型并放入指定目录：\n\n1. **换脸模型** (可选，支持 Inswapper, ReSwapper, HyperSwap):\n   - 下载地址: [HuggingFace - Gourieff\u002FReActor](https:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels) 或 [FaceFusion Models](https:\u002F\u002Fhuggingface.co\u002Ffacefusion\u002Fmodels-3.3.0\u002Ftree\u002Fmain)\n   - 放置目录:\n     - Inswapper\u002FReSwapper: `ComfyUI\u002Fmodels\u002Finswapper` 或 `ComfyUI\u002Fmodels\u002Freswapper`\n     - HyperSwap: `ComfyUI\u002Fmodels\u002Fhyperswap` (需下载 `hyperswap_1a_256.onnx` 等)\n\n2. **检测与修复模型** (可选，用于高级功能):\n   - `face_yolov8m.pt`: 放入 `ComfyUI\u002Fmodels\u002Fultralytics\u002Fbbox`\n   - `sam_vit_b_01ec64.pth`: 放入 `ComfyUI\u002Fmodels\u002Fsams`\n   - 面部修复模型 (GPEN 等): 放入 `ComfyUI\u002Fmodels\u002Ffacerestore_models`\n\n## 基本使用\n\n### 1. 最简单的工作流\n创建一个基础的换脸工作流，只需三个核心节点：\n\n1. **加载源图像 (Load Image)**: 上传包含目标人脸的图片（Source）。\n2. **加载目标图像 (Load Image)**: 上传需要被换脸的图片（Target）。\n3. **ReActor Face Swap 节点**:\n   - 将源图像连接到 `source_image` 输入。\n   - 将目标图像连接到 `target_image` 输入。\n   - **Source Face Index**: 设置源图中使用哪张脸（0 代表第一张检测到的脸）。\n   - **Target Face Index**: 设置目标图中替换哪张脸（留空或设为 `0` 替换所有检测到的脸，或用逗号分隔如 `0,1` 指定特定脸部）。\n   - 点击 \"Queue Prompt\" 生成结果。\n\n### 2. 进阶功能示例\n\n#### 调整换脸强度\n使用 `ReActorSetWeight` 节点控制换脸融合度（0% - 100%）：\n- 将 `ReActor Face Swap` 的输出连接到 `ReActorSetWeight` 的输入。\n- 调整 `weight` 参数（步长 12.5%），数值越低保留原图特征越多。\n\n#### 面部修复与增强\n若换脸后画质模糊，可启用修复功能：\n- 在 `ReActor Face Swap` 节点中勾选 **Face Restoration**。\n- 选择修复模型（如 CodeFormer 或 GPEN）。\n- 或使用新版节点 `Restore Face Advanced` 对特定区域进行精细化修复。\n\n#### 混合人脸模型 (Blended Face Model)\n为了提高相似度，可将同一个人的多张照片混合成一个模型：\n1. 使用 `Make Image Batch` 节点加载多张同一人的照片。\n2. 连接到 `ReActorBuildFaceModel` 节点。\n3. 将生成的 `face_model` 输出连接到主换脸节点的 `face_model` 输入（替代直接使用 `source_image`）。\n\n### 注意事项\n- **合规性**: 本插件内置 NSFW 检测器，若检测到违规内容将拒绝处理，请确保使用合法合规的素材。\n- **显存管理**: 处理复杂工作流或视频时，若显存不足，可使用 `Unload ReActor Models` 节点释放资源。\n- **顺序控制**: 默认按人脸大小排序，可在 `ReActorOptions` 节点中自定义源图和目标图的人脸索引顺序。","一位独立游戏开发者正在为视觉小说项目批量生成角色立绘，需要将同一张参考人脸自然地融合到多种不同风格、光影和角度的 AI 生成底图中。\n\n### 没有 ComfyUI-ReActor 时\n- **工作流断裂**：必须在 ComfyUI 生成底图后，导出图片再到外部软件（如 Roop 或 Photoshop）进行换脸，无法在一个流程中完成闭环。\n- **细节丢失严重**：传统换脸方式难以适应复杂的光影变化，导致替换后的面部与身体肤色不均，或在侧脸角度下出现明显的拼接痕迹。\n- **修复破坏整体**：使用全局面部修复（Face Restore）时，往往会错误地重绘背景或其他非目标人物的脸部，导致画面逻辑混乱。\n- **效率低下**：每调整一次提示词或模型参数，都需要重复“生成 - 导出 - 换脸 - 导入”的繁琐步骤，严重拖慢迭代速度。\n\n### 使用 ComfyUI-ReActor 后\n- **全流程自动化**：直接在 ComfyUI 节点图中串联换脸逻辑，实现从文本提示词到最终换脸成图的一键式生成，无需任何手动干预。\n- **精准光影融合**：利用其内置的高级交换模型（如 HyperSwap），能自动匹配底图的光照和色调，即使在极端角度下也能保持面部纹理自然逼真。\n- **局部智能修复**：借助新增的\"Restore Face Advanced\"节点，仅对换脸区域进行高清修复，完美保留背景和其他人物特征，避免误操作。\n- **批量高效产出**：修改工作流参数后可立即批量重绘，快速验证不同艺术风格下的角色表现，将原本数小时的工作压缩至几分钟。\n\nComfyUI-ReActor 通过将高精度换脸能力原生集成到生成工作流中，彻底解决了多角色一致性难题，让创作者能专注于艺术构思而非繁琐的后期合成。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FGourieff_ComfyUI-ReActor_d20593fd.png","Gourieff","Art Gourieff","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FGourieff_82b70d19.png","Writer, photographer, artist, engineer;\r\n ReActor Fast Face Swap Extension for SD WebUI and ComfyUI",null,"https:\u002F\u002Fboosty.to\u002Fartgourieff","https:\u002F\u002Fgithub.com\u002FGourieff",[81,85,89,93],{"name":82,"color":83,"percentage":84},"Python","#3572A5",91.3,{"name":86,"color":87,"percentage":88},"Cuda","#3A4E3A",5.1,{"name":90,"color":91,"percentage":92},"C++","#f34b7d",3.5,{"name":94,"color":95,"percentage":96},"Batchfile","#C1F12E",0.1,1182,216,"2026-04-19T05:53:55","GPL-3.0","Windows, Linux, macOS","需要 GPU 加速（支持 NVIDIA CUDA 或 AMD ROCm），macOS 支持 CoreML。显存需求取决于模型和分辨率，建议 8GB+ 以获得最佳性能，支持 ORT-GPU、CoreML 和 ROCM EPs。","未说明（建议 16GB+ 以处理视频和多面部检测）",{"notes":105,"python":106,"dependencies":107},"1. 本工具是 ComfyUI 的节点插件，需先安装 ComfyUI。\n2. 支持多种换脸模型：Inswapper（默认）、ReSwapper、HyperSwap，需手动下载模型文件放入指定目录。\n3. 内置 NSFW（色情内容）检测器，会自动阻止不当内容。\n4. 支持 NVIDIA CUDA、AMD ROCm 以及 macOS 的 CoreML 加速，需安装对应版本的 onnxruntime。\n5. 首次使用需下载人脸检测 (YOLOv8)、分割 (SAM) 及换脸模型文件。\n6. 提供‘卸载模型’节点以在复杂工作流中释放显存。","未说明（依赖 ComfyUI 环境，通常为 3.10+）",[108,109,110,111,112,113,114],"onnxruntime","inswapper_128.onnx (模型)","reswapper 模型 (可选)","hyperswap 模型 (可选)","face_yolov8m.pt (检测模型)","sam_vit_b_01ec64.pth (分割模型)","GFPGAN\u002FGPEN (修复模型)",[15],[117,118,119],"comfyui","comfyui-nodes","face-swapping","2026-03-27T02:49:30.150509","2026-04-20T04:05:12.333371",[123,128,133,137,142,147],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},43728,"遇到 'weights_only load failed' 或 'Unsupported global: GLOBAL ultralytics.nn.modules.Conv' 错误如何解决？","这是由于 PyTorch 2.6 默认开启了安全加载模式导致的。解决方法是安装 'comfyui-unsafe-torch' 插件：\n1. 进入 ComfyUI 的 custom_nodes 文件夹（例如 C:\\ComfyUI\\custom_nodes）。\n2. 在地址栏输入 'cmd' 并回车打开命令行。\n3. 运行命令：git clone https:\u002F\u002Fgithub.com\u002Fltdrdata\u002Fcomfyui-unsafe-torch\n   或者下载该仓库的 ZIP 包并解压到 custom_nodes 文件夹中。\n4. 重启 ComfyUI 即可生效。","https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F73",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},43729,"Hyperswap 模型已下载并放入文件夹，但在列表中无法选择怎么办？","这通常是因为 ComfyUI Manager 的注册表未更新导致模型未被识别。请尝试更新 ComfyUI Manager 或重启 ComfyUI 以刷新模型列表。如果问题依旧，请检查模型文件是否确实放在了正确的 'hyperswap' 子文件夹中。","https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F204",{"id":134,"question_zh":135,"answer_zh":136,"source_url":132},43730,"使用 Hyperswap 模型时换脸效果不佳或失败（FAIL SWAP）该如何调整？","Hyperswap 模型在处理某些相似人脸时可能存在已知缺陷。建议按以下顺序尝试不同版本的模型以获得最佳稳定性：\n1. 优先尝试 'Hyperswap_1b'（质量较高）。\n2. 如果 1b 失败，尝试 'Hyperswap_1c'。\n3. 如果 1c 也失败，尝试最稳定的 'Hyperswap_1a'。\n4. 如果以上都无效，请回退使用 'Inswapper-128' 配合 'GPEN-BFR-512' 模型。",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},43731,"输出图像全黑且日志显示正在检查不安全内容（Checking for any unsafe content）是什么原因？","这通常是因为内置的 NSFW（色情内容）检测过滤器误判了图片，导致所有输出被拦截。虽然日志可能未明确报错，但图片被静默丢弃。解决方案包括：\n1. 检查输入图片是否包含可能被误判的元素。\n2. 高级用户可以修改源码文件 'reactor_sfw.py'，调整检测阈值或在代码中添加日志以确认图片是否通过了安全检查（将检测逻辑中的返回条件放宽或添加 else 分支打印 'is SAFE' 状态）。","https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F57",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},43732,"预览图像显示为黑色但工作流其他部分正常，可能是什么原因？","如果预览图是全黑的，首先请检查输入的图片尺寸是否过小，过小的图片可能导致处理失败从而显示黑图。如果图片尺寸正常，请尝试更换不同的 FaceRestoreModel（如 CodeFormer 或 GFPGAN）或调整相关节点的设置，有时模型加载顺序或特定模型的兼容性问题也会导致此现象。","https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F15",{"id":148,"question_zh":149,"answer_zh":150,"source_url":127},43733,"如何手动安装缺失的依赖或插件（如 git 方式）？","对于需要手动安装的插件（如解决 torch 加载问题的插件）：\n1. 打开终端（CMD 或 PowerShell）。\n2. 导航到 ComfyUI 的 'custom_nodes' 目录。\n3. 执行 'git clone \u003C仓库地址>' 命令克隆插件代码。\n4. 如果没有安装 Git，可以下载仓库的 ZIP 压缩包，解压后将文件夹放入 'custom_nodes' 目录。\n5. 完成后务必重启 ComfyUI。",[152,157,162],{"id":153,"version":154,"summary_zh":155,"released_at":156},351151,"v0.6.1","**新功能：**\n\n- 针对多张人脸和多个索引，性别检测逻辑得到优化\n- MaskHelper 节点速度提升至2倍——虽然仍不完美，但相比之前快了1.5到2倍\n- ComfyUI 原生进度条，适用于不同步骤\n- 主节点新增 ORIGINAL_IMAGE 输出\n- 各种修复与改进（修复了 https:\u002F\u002Fgithub.com\u002FGourieff\u002FComfyUI-ReActor\u002Fissues\u002F25；NSFW 检测器不再生成临时文件；NSFW 检测器速度略有提升）","2025-09-05T05:53:53",{"id":158,"version":159,"summary_zh":160,"released_at":161},351152,"v0.6.0","**更新内容：**\n\n- 新节点 `ReActorSetWeight` - 现在可以将 `source_image` 或 `face_model` 的人脸替换强度设置为 0% 至 100%，步长为 12.5%。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.0-whatsnew-01.jpg?raw=true\" alt=\"0.6.0-whatsnew-01\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.0-whatsnew-02.jpg?raw=true\" alt=\"0.6.0-whatsnew-02\" width=\"100%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.6.0-alpha1-01.gif?raw=true\" alt=\"0.6.0-whatsnew-03\" width=\"540px\"\u002F>\n\u003C\u002Fcenter>","2025-05-21T07:12:19",{"id":163,"version":164,"summary_zh":165,"released_at":166},351153,"v0.5.2","**更新内容：**\n\n- 支持 ReSwapper 模型。尽管 Inswapper 仍然在相似度方面表现最佳，但 ReSwapper 正在不断进化——感谢 @somanchiu！https:\u002F\u002Fgithub.com\u002Fsomanchiu\u002FReSwapper 提供了 ReSwapper 模型及项目！这对于社区来说，是 Inswapper 替代方案迈出的重要一步！\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.2-whatsnew-03.jpg?raw=true\" alt=\"0.5.2-whatsnew-03\" width=\"75%\"\u002F>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.2-whatsnew-04.jpg?raw=true\" alt=\"0.5.2-whatsnew-04\" width=\"75%\"\u002F>\n\u003C\u002Fcenter>\n\n您可在此处下载 ReSwapper 模型：\nhttps:\u002F\u002Fhuggingface.co\u002Fdatasets\u002FGourieff\u002FReActor\u002Ftree\u002Fmain\u002Fmodels\n只需将其放入“models\u002Freswapper”目录即可。\n\n- 添加了 NSFW 检测器，以避免违反 [GitHub 规则](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fsite-policy\u002Facceptable-use-policies\u002Fgithub-misinformation-and-disinformation#synthetic--manipulated-media-tools)。\n- 新增节点“卸载 ReActor 模型”——在复杂的工作流中，当需要释放 ReActor 占用的显存时，此节点非常有用。\n\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.2-whatsnew-01.jpg?raw=true\" alt=\"0.5.2-whatsnew-01\" width=\"100%\"\u002F>\n\n- 支持 ORT CoreML 和 ROCM EP，只需安装所需版本的 onnxruntime 即可。\n- 安装脚本已优化，可自动安装最新版本的 ORT-GPU。\n\n\u003Ccenter>\n\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FGourieff\u002FAssets\u002Fblob\u002Fmain\u002Fcomfyui-reactor-node\u002F0.5.2-whatsnew-02.jpg?raw=true\" alt=\"0.5.2-whatsnew-02\" width=\"50%\"\u002F>\n\u003C\u002Fcenter>\n\n- 修复与改进","2025-03-03T05:46:29"]