StabilityMatrix 기반 ReActor 페이스 스왑 완전 설치 가이드

StabilityMatrix + Forge 기반 WebUI 환경에서 ReActor(SFW) 확장을 설치하고, 페이스스왑 기능을 완전히 활용하는 방법을 정리합니다.

---

1. ReActor 설치

설치 경로 예시:

 

 

설치 방법:

1. Stable Diffusion WebUI 실행
2. 상단 메뉴 → Extensions > Install from URL 탭으로 이동
3. https://github.com/Gourieff/sd-webui-reactor-sfw 주소 입력 후 Install
4. D:\...\Data\Packages\stable-diffusion-webui-forge\extensions\sd-webui-reactor-sfw 설치확인
5. 설치 완료 후 WebUI 재시작
6. webui화면에  [ReActor] 기능이 보이면 설치 완료

 

ReActor 설치

설치 완료 - ReActor 기능 활성화됨

---

2. ReActor용 얼굴 스왑 모델 설치

ReActor는 얼굴 교체를 위해 ONNX 모델을 필요로 합니다.
모델이 없으면 작동하지 않습니다.

모델 다운로드:

https://huggingface.co/ezioruan/inswapper_128.onnx/blob/main/inswapper_128.onnx

저장 위치:

D:\ai\StabilityMatrix-win-x64\Data\Packages\stable-diffusion-webui-forge\extensions\sd-webui-reactor-sfw\models

※ models 폴더가 없다면 새로 생성한 후, 해당 파일을 저장하세요.

---

3. 선택사항: 이미지 제한 판단 로직 비활성화

일부 이미지에서 얼굴이 교체되지 않는 경우가 있습니다.
이는 안전성 판단(검열) 로직이 작동 중일 수 있기 때문입니다.
해당 로직을 제거하여 모든 이미지에서 교체 시도를 허용할 수 있습니다.

원본)

from transformers import pipeline
from PIL import Image
import logging
import torch

SCORE = 1 # 0.965 and less - is safety content

logging.getLogger('transformers').setLevel(logging.ERROR)

def nsfw_image(img_path: str, model_path: str):
    device = 'cuda' if torch.cuda.is_available() else 'cpu'
    with Image.open(img_path) as img:
        predict = pipeline("image-classification", model=model_path)
        predict.model.to(device)
        result = predict(img)
        score = result[0]["score"]
        print(f"NSFW Score = {score}")
        return True if score > SCORE else False



수정)

from transformers import pipeline
from PIL import Image
import logging
import torch

# NSFW 필터 완전 제거 버전
# 검열 판단 로직 자체를 생략하여 무조건 안전 판정 처리

logging.getLogger('transformers').setLevel(logging.ERROR)

def nsfw_image(img_path: str, model_path: str):
    print("NSFW 필터 우회: 모든 이미지 통과됨")
    return False

---

4. 테스트 팁

• 기존에 얼굴이 교체되지 않았던 이미지로 재시도
• 콘솔에 출력되는 메시지에서 NSFW 관련 판단이 생략됐는지 확인
• 이미지의 얼굴 방향, 조명에 따라 정확도 차이가 있을 수 있음

---

5. 기능실행

원본이미지 

원본이미지

소스이미지

소스이미지

결과

결과이미지

(원본이미지 <-> 소스이미지) = 결과

마무리

ReActor는 얼굴 기반 이미지 제어에서 매우 유용한 확장 기능입니다.
StabilityMatrix 환경에서 완전하게 설정하면, 다양한 스타일 이미지에 원하는 얼굴을 자연스럽게 적용할 수 있습니다.

추가적으로 포즈 변경, 의상 전환 등 전체 바디 기반 제어가 필요할 경우, ControlNet이나 IPAdapter 등의 기술과 병행 사용하는 것을 추천합니다.