README.md

---
title: Magic Face V3
emoji: 🤪
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
license: mit
short_description: Source-code Include
---
Looking at this code, it's a Gradio-based web application called "MagicFace V3" that uses IP-Adapter technology to transform user faces into various character styles. Here's a detailed explanation:

## English Explanation

### Overview
MagicFace V3 is an AI-powered face transformation application that uses Stable Diffusion with IP-Adapter FaceID technology. It allows users to upload their photos and transform them into various artistic styles or fictional characters while preserving their facial identity.

### Key Features
1. **Face Identity Preservation**: Uses InsightFace for face detection and embedding extraction, ensuring the generated images maintain the user's facial features
2. **Multiple Image Support**: Can process multiple photos of the same person to create a better average representation
3. **Preset Styles**: Offers 10 pre-configured transformation styles including:
   - Classic art styles (Mona Lisa, Van Gogh)
   - Fictional characters (Iron Hero, Star Wars Jedi, Matrix Hero)
   - Historical figures (Egyptian Pharaoh, Greek God, Medieval Knight)
   - Adventure themes (Pirate Captain, Sherlock Holmes)
4. **Custom Prompts**: Users can write their own transformation descriptions
5. **Gender Selection**: Optimizes generation based on selected gender

### Technical Components
- **Base Model**: Realistic_Vision_V4.0_noVAE
- **IP-Adapter**: FaceID and FaceID Plus models for facial feature preservation
- **Face Analysis**: Buffalo_l model from InsightFace
- **Generation Parameters**: 
  - 512x768 resolution
  - 100 inference steps
  - Face strength: 2.1
  - Likeness strength: 0.7

### How It Works
1. User uploads one or more face photos
2. The system extracts facial embeddings using InsightFace
3. If multiple photos are provided, it averages the embeddings
4. The face is aligned and cropped for better results
5. IP-Adapter integrates the facial features into the Stable Diffusion generation process
6. The system generates a single portrait with the specified style while maintaining facial identity

### Safety Features
- Includes negative prompts to prevent multiple people in generated images
- Ensures single person portraits only
- GPU acceleration via Spaces for faster processing

---

## 한글 설명

### 개요
MagicFace V3는 IP-Adapter FaceID 기술과 Stable Diffusion을 활용한 AI 기반 얼굴 변환 애플리케이션입니다. 사용자가 업로드한 사진을 다양한 예술적 스타일이나 가상의 캐릭터로 변환하면서도 얼굴의 정체성을 유지합니다.

### 주요 기능
1. **얼굴 정체성 보존**: InsightFace를 사용하여 얼굴을 감지하고 임베딩을 추출하여 생성된 이미지가 사용자의 얼굴 특징을 유지하도록 합니다
2. **다중 이미지 지원**: 동일인의 여러 사진을 처리하여 더 나은 평균 표현을 생성할 수 있습니다
3. **사전 설정 스타일**: 10가지 사전 구성된 변환 스타일 제공:
   - 클래식 아트 스타일 (모나리자, 반 고흐)
   - 가상 캐릭터 (아이언 히어로, 스타워즈 제다이, 매트릭스 히어로)
   - 역사적 인물 (이집트 파라오, 그리스 신, 중세 기사)
   - 모험 테마 (해적 선장, 셜록 홈즈)
4. **사용자 정의 프롬프트**: 사용자가 원하는 변환 설명을 직접 작성 가능
5. **성별 선택**: 선택된 성별에 따라 생성 최적화

### 기술적 구성요소
- **기본 모델**: Realistic_Vision_V4.0_noVAE
- **IP-어댑터**: 얼굴 특징 보존을 위한 FaceID 및 FaceID Plus 모델
- **얼굴 분석**: InsightFace의 Buffalo_l 모델
- **생성 매개변수**: 
  - 512x768 해상도
  - 100 추론 단계
  - 얼굴 강도: 2.1
  - 유사도 강도: 0.7

### 작동 방식
1. 사용자가 한 장 이상의 얼굴 사진을 업로드
2. 시스템이 InsightFace를 사용하여 얼굴 임베딩 추출
3. 여러 사진이 제공된 경우 임베딩의 평균값 계산
4. 더 나은 결과를 위해 얼굴 정렬 및 크롭
5. IP-Adapter가 얼굴 특징을 Stable Diffusion 생성 프로세스에 통합
6. 지정된 스타일로 얼굴 정체성을 유지하면서 단일 인물 초상화 생성

### 안전 기능
- 생성된 이미지에 여러 사람이 나타나는 것을 방지하는 네거티브 프롬프트 포함
- 단일 인물 초상화만 생성되도록 보장
- 빠른 처리를 위한 Spaces GPU 가속

이 애플리케이션은 사용자의 얼굴을 다양한 예술적 스타일로 변환하면서도 본인의 얼굴 특징을 유지하는 혁신적인 AI 도구입니다.