This project provides a fast and simple face-swapping extension for Stable Diffusion WebUIs, designed to be SFW-friendly with an integrated nudity detector. It targets users of AUTOMATIC1111, SD.Next, and Cagliostro, offering a user-friendly interface for seamless face replacement in images, with benefits including improved workflow efficiency and creative control.

How It Works

The extension leverages the InsightFace library for its core face-swapping functionality, utilizing pre-trained models like inswapper_128.onnx. It processes images to detect and replace faces, offering features such as gender detection, face restoration, and upscaling of the swapped face. The architecture supports multiple faces, allows for saving and loading face models as safetensors, and includes facial mask correction to refine face contours, aiming for high accuracy and speed.

Quick Start & Requirements

Installation is typically done via the "Extensions" tab in the respective Stable Diffusion WebUI, by searching for "ReActor" or providing the GitHub URL. Windows users may need to install Visual Studio 2022 with C++ build tools. Compatibility is noted with CUDA 12 support.

Highlighted Details

• Supports X/Y/Z plotting for multiple face models and parameters like CodeFormer Weight and Restorer Visibility.
• Allows blending faces to create custom face models.
• Offers an "Extras" tab integration for faster face2face swaps outside the main SD pipeline.
• Provides API support for both built-in and external use.

Maintenance & Community

The project is actively maintained, with recent updates focusing on feature enhancements and bug fixes. Links to community resources like Discord/Slack are not explicitly provided in the README, but the commit activity and issue tracking suggest ongoing development.

Licensing & Compatibility

The extension itself appears to be under a permissive license (indicated by the GitHub license badge, likely MIT or similar). However, it utilizes InsightFace's pre-trained models, which are explicitly licensed for non-commercial research purposes only. Commercial use would require training custom models or sourcing commercially licensed alternatives.

Limitations & Caveats

The primary limitation is the non-commercial use restriction of the included InsightFace models, which significantly impacts commercial applications. Users may also encounter compatibility issues or conflicts with other extensions, as detailed in the extensive troubleshooting section. The NSFW filter is described as a philosophical stance rather than a technical implementation.