s0md3v/roopView GitHub Homepage for Latest Official Releases

원클릭 얼굴 교체 딥페이크 도구로, 사진 한 장으로 비디오 속 얼굴을 교체할 수 있습니다.

GPL-3.0Pythonroops0md3v 30.1k Last Updated: August 19, 2024

Roop - 원클릭 얼굴 교체 도구

프로젝트 개요

Roop는 GitHub 사용자 s0md3v가 개발한 오픈 소스 딥페이크(Deepfake) 도구입니다. 이 프로젝트의 핵심 기능은 단 한 장의 사진으로 비디오 속 얼굴을 교체하는 것이며, 데이터 세트나 훈련이 필요하지 않습니다. 현재 프로젝트 업데이트는 중단되었지만 정상적으로 사용할 수 있습니다.

GitHub 주소: https://github.com/s0md3v/roop

주요 특징

핵심 기능

  • 원클릭 조작: 간단하고 사용하기 쉬운 얼굴 교체 기능
  • 단일 이미지 입력: 목표 얼굴 사진 한 장만 필요
  • 비디오 처리: 비디오 전체에 대한 얼굴 교체 지원
  • 훈련 불필요: 모델을 미리 훈련하거나 대량의 데이터 세트를 준비할 필요 없음

기술 특징

  • 딥러닝 기술 기반
  • CPU 및 GPU 가속 지원
  • 사전 훈련된 모델 사용
  • 다양한 출력 형식 지원

설치 요구 사항

프로젝트 설치에는 어느 정도의 기술적 숙련도가 필요하며 초보자에게는 적합하지 않습니다. 주요 설치 방법은 다음과 같습니다.

기본 설치

  • 호환성이 더 좋지만 처리 속도가 느림
  • 계산 자원이 제한된 환경에 적합

가속 설치

  • CPU 및 GPU 성능을 최대한 활용
  • 처리 속도가 더 빠르며 독립 실행형 그래픽 카드가 있는 사용자에게 적합

사용 방법

명령줄 매개변수

프로그램은 명령줄을 통해 실행되며 기본 구문은 다음과 같습니다.

python run.py [options]

주요 매개변수 설명

기본 매개변수

  • -h, --help: 도움말 정보 표시
  • -s SOURCE_PATH, --source SOURCE_PATH: 소스 이미지 선택
  • -t TARGET_PATH, --target TARGET_PATH: 대상 이미지 또는 비디오 선택
  • -o OUTPUT_PATH, --output OUTPUT_PATH: 출력 파일 또는 디렉토리 선택

처리 매개변수

  • --frame-processor: 프레임 프로세서 선택 (face_swapper, face_enhancer 등)
  • --keep-fps: 대상 프레임 속도 유지
  • --keep-frames: 임시 프레임 보존
  • --skip-audio: 대상 오디오 건너뛰기
  • --many-faces: 모든 얼굴 처리

얼굴 인식 매개변수

  • --reference-face-position: 참조 얼굴 위치
  • --reference-frame-number: 참조 프레임 번호
  • --similar-face-distance: 얼굴 인식에 사용되는 거리

출력 설정

  • --temp-frame-format {jpg,png}: 프레임 추출 이미지 형식
  • --temp-frame-quality [0-100]: 프레임 추출 이미지 품질
  • --output-video-encoder: 출력 비디오 인코더 선택
    • libx264, libx265, libvpx-vp9, h264_nvenc, hevc_nvenc
  • --output-video-quality [0-100]: 출력 비디오 품질

성능 매개변수

  • --max-memory MAX_MEMORY: 최대 RAM 사용량 (GB)
  • --execution-provider {cpu}: 사용 가능한 실행 제공자
  • --execution-threads: 실행 스레드 수

헤드리스 모드 실행

-s/--source, -t/--target 및 -o/--output 매개변수를 사용하여 헤드리스 모드에서 프로그램을 실행할 수 있으며 자동화된 처리에 적합합니다.

기술 아키텍처

핵심 종속성

  • InsightFace: 프로젝트는 deepinsight 팀이 개발한 insightface 라이브러리를 사용합니다.
  • 타사 라이브러리: 사전 훈련된 모델과 타사 라이브러리를 광범위하게 사용합니다.
  • 딥러닝 프레임워크: 현대 딥러닝 기술 기반

처리 흐름

  1. 소스 얼굴 이미지와 대상 비디오 입력
  2. 얼굴 특징 감지 및 분석
  3. 얼굴 교체 처리 수행
  4. 처리된 비디오 파일 출력

사용 시나리오

정당한 용도

  • 예술 창작: 예술가의 캐릭터 애니메이션 제작 지원
  • 의류 모델링: 의류 모델에게 다양한 얼굴 제공
  • 엔터테인먼트 콘텐츠: 재미있는 비디오 콘텐츠 제작
  • 교육 데모: 기술 데모 및 교육에 사용

윤리적 고려 사항 및 책임 고지

도덕적 사용 지침

이 소프트웨어는 AI 생성 미디어 산업에 긍정적인 기여를 하고 예술가가 캐릭터 애니메이션 및 의류 모델과 같은 작업을 완료하도록 돕는 것을 목표로 합니다.

안전 조치

  • 소프트웨어가 부적절한 콘텐츠(예: 나체)에 사용되는 것을 방지하기 위한 조치 시행
  • 사용자는 현지 법률을 준수하고 책임감 있게 소프트웨어를 사용할 것으로 기대

사용자 책임

  • 실제 얼굴을 사용하는 경우 동의를 얻고 공유 시 딥페이크 콘텐츠임을 명확하게 표시해야 합니다.
  • 개발자는 사용자 행동에 대해 책임을 지지 않습니다.
  • 사용자는 관련 현지 법규를 준수해야 합니다.

프로젝트 상태

중요 알림: 이 프로젝트는 현재 사용할 수 있지만 업데이트 수신이 중단되었습니다. 개발자는 소프트웨어의 추가 개발을 감독할 의향이나 시간이 없다고 밝혔습니다.

개발자는 프로젝트를 최종 형태로 만드는 데 기여한 모든 사람에게 감사를 표합니다.

문서 및 지원

  • 자세한 문서: https://github.com/s0md3v/roop/wiki
  • GitHub에서 플랫폼 및 설치 관련 질문은 더 이상 받지 않습니다.
  • 사용자에게 오류가 발생하면 스스로 해결 방법을 검색해야 합니다.

요약

Roop는 강력하지만 신중하게 사용해야 하는 AI 도구입니다. 이는 비디오 처리 분야에서 현대 딥러닝 기술의 응용 가능성을 보여주는 동시에 이러한 기술을 사용할 때 해당되는 윤리적 및 법적 책임을 상기시켜 줍니다. 사용자는 사용하기 전에 관련 위험을 충분히 이해하고 사용 방법이 법규 및 윤리적 기준을 준수하는지 확인해야 합니다.

Star History Chart