README.md

---
title: 3D Style Image Gen R1
emoji: 🖼🏆
colorFrom: purple
colorTo: red
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
license: openrail++
short_description: '3D Style Image Generator R1: Fast & High Quality Mode'
---
I'll analyze this code and provide explanations in both English and Korean.

## English Explanation

This is a **3D Style Image Generator** application built with Gradio and Hugging Face's Diffusers library. Here's what it does:

### Key Features:
1. **Image Generation**: Uses FLUX.1-dev model with Hyper-SD LoRA for fast, high-quality 3D-style image generation
2. **Korean Translation**: Automatically detects and translates Korean prompts to English using Helsinki-NLP translator
3. **Web Interface**: Clean Gradio interface with customizable generation parameters
4. **Gallery Display**: Shows pre-generated sample images with their prompts

### Technical Components:
- **Model**: FLUX.1-dev with Hyper-SD 8-step LoRA for accelerated inference
- **GPU Acceleration**: Uses CUDA with bfloat16 precision for efficiency
- **Caching**: Implements local model caching to avoid repeated downloads
- **Image Saving**: Automatically saves generated images with timestamps

### User Controls:
- **Prompt Input**: Text description for the desired 3D image
- **Advanced Settings**:
  - Image dimensions (256-1152 pixels)
  - Inference steps (6-25 steps)
  - Guidance scale (0.0-5.0)
  - Seed control for reproducibility

### Workflow:
1. User enters a prompt (Korean or English)
2. Korean prompts are automatically translated
3. Prompt is formatted with "wbgmsst, 3D, [prompt], white background"
4. Model generates the image using specified parameters
5. Image is displayed and saved to gallery

---

## 한글 설명

이것은 Gradio와 Hugging Face의 Diffusers 라이브러리를 사용하여 구축된 **3D 스타일 이미지 생성기** 애플리케이션입니다.

### 주요 기능:
1. **이미지 생성**: FLUX.1-dev 모델과 Hyper-SD LoRA를 사용하여 빠르고 고품질의 3D 스타일 이미지 생성
2. **한국어 번역**: Helsinki-NLP 번역기를 사용하여 한국어 프롬프트를 자동으로 감지하고 영어로 번역
3. **웹 인터페이스**: 사용자 정의 가능한 생성 매개변수가 있는 깔끔한 Gradio 인터페이스
4. **갤러리 표시**: 미리 생성된 샘플 이미지와 해당 프롬프트 표시

### 기술적 구성요소:
- **모델**: 가속화된 추론을 위한 Hyper-SD 8단계 LoRA가 적용된 FLUX.1-dev
- **GPU 가속**: 효율성을 위해 bfloat16 정밀도로 CUDA 사용
- **캐싱**: 반복 다운로드를 피하기 위한 로컬 모델 캐싱 구현
- **이미지 저장**: 생성된 이미지를 타임스탬프와 함께 자동 저장

### 사용자 제어 기능:
- **프롬프트 입력**: 원하는 3D 이미지에 대한 텍스트 설명
- **고급 설정**:
  - 이미지 크기 (256-1152 픽셀)
  - 추론 단계 (6-25 단계)
  - 가이던스 스케일 (0.0-5.0)
  - 재현성을 위한 시드 제어

### 작동 과정:
1. 사용자가 프롬프트 입력 (한국어 또는 영어)
2. 한국어 프롬프트는 자동으로 번역됨
3. 프롬프트가 "wbgmsst, 3D, [프롬프트], white background" 형식으로 포맷됨
4. 모델이 지정된 매개변수를 사용하여 이미지 생성
5. 이미지가 표시되고 갤러리에 저장됨

### 특별 기능:
- **한국어 지원**: 한국어로 프롬프트를 입력하면 자동으로 영어로 번역되어 처리
- **빠른 생성**: Hyper-SD LoRA를 사용하여 8단계만으로도 고품질 이미지 생성
- **갤러리**: 다양한 스타일의 샘플 이미지를 참고할 수 있는 갤러리 제공
- **시드 제어**: 동일한 이미지를 재생성할 수 있도록 시드 값 제어 가능