README.md

---
title: PuLID based FLUX FaceID
emoji: 🤗
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
license: apache-2.0
---
## PuLID for FLUX: Portrait-Guided Image Generation

This code implements **PuLID (Pure and Lightning ID customization)** for FLUX.1-dev, an advanced image generation system that allows users to create personalized images using ID (identity) images as guidance. The system combines the power of FLUX diffusion models with identity preservation capabilities.

### Key Features

**1. Identity-Guided Generation**
- Upload an ID image (portrait photo) to guide the generation process
- Control identity strength with adjustable ID weight (0.0-3.0)
- Preserve facial features while applying various artistic styles

**2. Advanced Configuration Options**
- **Resolution Control**: Adjustable width (256-1536px) and height (256-1536px)
- **Generation Steps**: 1-20 steps for quality vs speed tradeoff
- **Guidance Scale**: Fine-tune adherence to prompts (1.0-10.0)
- **Seed Control**: Reproducible results with manual seed input

**3. True CFG (Classifier-Free Guidance)**
- Fake CFG mode (scale=1): Faster generation with basic guidance
- True CFG mode (scale>1): Enhanced quality with negative prompt support
- Configurable timestep for CFG activation

**4. Technical Architecture**
- Built on FLUX.1-dev diffusion model
- Utilizes T5 text encoder for prompt understanding
- CLIP model for image-text alignment
- Autoencoder for latent space operations
- GPU acceleration with CUDA support

### How It Works

1. **Text Prompt Input**: Describe the desired image style (e.g., "portrait, pixar")
2. **ID Image Upload**: Provide a reference portrait for identity guidance
3. **Parameter Tuning**: Adjust generation settings for optimal results
4. **Image Generation**: The model creates an image matching the prompt while preserving the identity

### Example Use Cases
- Transform portraits into different artistic styles (ice sculpture, pixar animation)
- Create personalized avatars maintaining facial identity
- Generate creative variations of portraits with text prompts
- Produce consistent character designs across different scenarios

The system leverages Gradio for an intuitive web interface, making advanced AI image generation accessible to users without technical expertise.

---

## PuLID for FLUX: 인물 기반 이미지 생성 시스템

이 코드는 FLUX.1-dev를 위한 **PuLID (Pure and Lightning ID customization)** 시스템을 구현한 것으로, ID(신원) 이미지를 가이드로 사용하여 개인화된 이미지를 생성할 수 있는 고급 이미지 생성 시스템입니다. FLUX 확산 모델의 강력한 성능과 신원 보존 기능을 결합하였습니다.

### 주요 기능

**1. 신원 기반 이미지 생성**
- ID 이미지(인물 사진)를 업로드하여 생성 과정 가이드
- 조절 가능한 ID 가중치(0.0-3.0)로 신원 강도 제어
- 다양한 예술적 스타일을 적용하면서도 얼굴 특징 보존

**2. 고급 설정 옵션**
- **해상도 제어**: 너비(256-1536px)와 높이(256-1536px) 조절 가능
- **생성 단계**: 품질 대 속도 균형을 위한 1-20단계 설정
- **가이던스 스케일**: 프롬프트 준수도 미세 조정(1.0-10.0)
- **시드 제어**: 수동 시드 입력으로 재현 가능한 결과 생성

**3. True CFG (Classifier-Free Guidance)**
- Fake CFG 모드(scale=1): 기본 가이던스로 빠른 생성
- True CFG 모드(scale>1): 부정 프롬프트 지원으로 향상된 품질
- CFG 활성화 시점 설정 가능

**4. 기술적 구조**
- FLUX.1-dev 확산 모델 기반
- T5 텍스트 인코더로 프롬프트 이해
- CLIP 모델로 이미지-텍스트 정렬
- 잠재 공간 작업을 위한 오토인코더
- CUDA 지원 GPU 가속

### 작동 방식

1. **텍스트 프롬프트 입력**: 원하는 이미지 스타일 설명 (예: "portrait, pixar")
2. **ID 이미지 업로드**: 신원 가이드를 위한 참조 인물 사진 제공
3. **매개변수 조정**: 최적의 결과를 위한 생성 설정 조절
4. **이미지 생성**: 모델이 신원을 보존하면서 프롬프트에 맞는 이미지 생성

### 활용 예시
- 인물 사진을 다양한 예술 스타일로 변환 (얼음 조각, 픽사 애니메이션)
- 얼굴 신원을 유지한 개인화된 아바타 생성
- 텍스트 프롬프트로 인물의 창의적인 변형 생성
- 다양한 시나리오에서 일관된 캐릭터 디자인 제작

이 시스템은 Gradio를 활용한 직관적인 웹 인터페이스를 제공하여, 기술적 전문 지식이 없는 사용자도 고급 AI 이미지 생성 기능을 쉽게 이용할 수 있습니다.