ginipick commited on
Commit
6206d0b
ยท
verified ยท
1 Parent(s): c884395

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +70 -1
README.md CHANGED
@@ -10,5 +10,74 @@ pinned: false
10
  license: openrail++
11
  short_description: '3D Style Image Generator R1: Fast & High Quality Mode'
12
  ---
 
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
  license: openrail++
11
  short_description: '3D Style Image Generator R1: Fast & High Quality Mode'
12
  ---
13
+ I'll analyze this code and provide explanations in both English and Korean.
14
 
15
+ ## English Explanation
16
+
17
+ This is a **3D Style Image Generator** application built with Gradio and Hugging Face's Diffusers library. Here's what it does:
18
+
19
+ ### Key Features:
20
+ 1. **Image Generation**: Uses FLUX.1-dev model with Hyper-SD LoRA for fast, high-quality 3D-style image generation
21
+ 2. **Korean Translation**: Automatically detects and translates Korean prompts to English using Helsinki-NLP translator
22
+ 3. **Web Interface**: Clean Gradio interface with customizable generation parameters
23
+ 4. **Gallery Display**: Shows pre-generated sample images with their prompts
24
+
25
+ ### Technical Components:
26
+ - **Model**: FLUX.1-dev with Hyper-SD 8-step LoRA for accelerated inference
27
+ - **GPU Acceleration**: Uses CUDA with bfloat16 precision for efficiency
28
+ - **Caching**: Implements local model caching to avoid repeated downloads
29
+ - **Image Saving**: Automatically saves generated images with timestamps
30
+
31
+ ### User Controls:
32
+ - **Prompt Input**: Text description for the desired 3D image
33
+ - **Advanced Settings**:
34
+ - Image dimensions (256-1152 pixels)
35
+ - Inference steps (6-25 steps)
36
+ - Guidance scale (0.0-5.0)
37
+ - Seed control for reproducibility
38
+
39
+ ### Workflow:
40
+ 1. User enters a prompt (Korean or English)
41
+ 2. Korean prompts are automatically translated
42
+ 3. Prompt is formatted with "wbgmsst, 3D, [prompt], white background"
43
+ 4. Model generates the image using specified parameters
44
+ 5. Image is displayed and saved to gallery
45
+
46
+ ---
47
+
48
+ ## ํ•œ๊ธ€ ์„ค๋ช…
49
+
50
+ ์ด๊ฒƒ์€ Gradio์™€ Hugging Face์˜ Diffusers ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊ตฌ์ถ•๋œ **3D ์Šคํƒ€์ผ ์ด๋ฏธ์ง€ ์ƒ์„ฑ๊ธฐ** ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค.
51
+
52
+ ### ์ฃผ์š” ๊ธฐ๋Šฅ:
53
+ 1. **์ด๋ฏธ์ง€ ์ƒ์„ฑ**: FLUX.1-dev ๋ชจ๋ธ๊ณผ Hyper-SD LoRA๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋น ๋ฅด๊ณ  ๊ณ ํ’ˆ์งˆ์˜ 3D ์Šคํƒ€์ผ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
54
+ 2. **ํ•œ๊ตญ์–ด ๋ฒˆ์—ญ**: Helsinki-NLP ๋ฒˆ์—ญ๊ธฐ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ•œ๊ตญ์–ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ž๋™์œผ๋กœ ๊ฐ์ง€ํ•˜๊ณ  ์˜์–ด๋กœ ๋ฒˆ์—ญ
55
+ 3. **์›น ์ธํ„ฐํŽ˜์ด์Šค**: ์‚ฌ์šฉ์ž ์ •์˜ ๊ฐ€๋Šฅํ•œ ์ƒ์„ฑ ๋งค๊ฐœ๋ณ€์ˆ˜๊ฐ€ ์žˆ๋Š” ๊น”๋”ํ•œ Gradio ์ธํ„ฐํŽ˜์ด์Šค
56
+ 4. **๊ฐค๋Ÿฌ๋ฆฌ ํ‘œ์‹œ**: ๋ฏธ๋ฆฌ ์ƒ์„ฑ๋œ ์ƒ˜ํ”Œ ์ด๋ฏธ์ง€์™€ ํ•ด๋‹น ํ”„๋กฌํ”„ํŠธ ํ‘œ์‹œ
57
+
58
+ ### ๊ธฐ์ˆ ์  ๊ตฌ์„ฑ์š”์†Œ:
59
+ - **๋ชจ๋ธ**: ๊ฐ€์†ํ™”๋œ ์ถ”๋ก ์„ ์œ„ํ•œ Hyper-SD 8๋‹จ๊ณ„ LoRA๊ฐ€ ์ ์šฉ๋œ FLUX.1-dev
60
+ - **GPU ๊ฐ€์†**: ํšจ์œจ์„ฑ์„ ์œ„ํ•ด bfloat16 ์ •๋ฐ€๋„๋กœ CUDA ์‚ฌ์šฉ
61
+ - **์บ์‹ฑ**: ๋ฐ˜๋ณต ๋‹ค์šด๋กœ๋“œ๋ฅผ ํ”ผํ•˜๊ธฐ ์œ„ํ•œ ๋กœ์ปฌ ๋ชจ๋ธ ์บ์‹ฑ ๊ตฌํ˜„
62
+ - **์ด๋ฏธ์ง€ ์ €์žฅ**: ์ƒ์„ฑ๋œ ์ด๋ฏธ์ง€๋ฅผ ํƒ€์ž„์Šคํƒฌํ”„์™€ ํ•จ๊ป˜ ์ž๋™ ์ €์žฅ
63
+
64
+ ### ์‚ฌ์šฉ์ž ์ œ์–ด ๊ธฐ๋Šฅ:
65
+ - **ํ”„๋กฌํ”„ํŠธ ์ž…๋ ฅ**: ์›ํ•˜๋Š” 3D ์ด๋ฏธ์ง€์— ๋Œ€ํ•œ ํ…์ŠคํŠธ ์„ค๋ช…
66
+ - **๊ณ ๊ธ‰ ์„ค์ •**:
67
+ - ์ด๋ฏธ์ง€ ํฌ๊ธฐ (256-1152 ํ”ฝ์…€)
68
+ - ์ถ”๋ก  ๋‹จ๊ณ„ (6-25 ๋‹จ๊ณ„)
69
+ - ๊ฐ€์ด๋˜์Šค ์Šค์ผ€์ผ (0.0-5.0)
70
+ - ์žฌํ˜„์„ฑ์„ ์œ„ํ•œ ์‹œ๋“œ ์ œ์–ด
71
+
72
+ ### ์ž‘๋™ ๊ณผ์ •:
73
+ 1. ์‚ฌ์šฉ์ž๊ฐ€ ํ”„๋กฌํ”„ํŠธ ์ž…๋ ฅ (ํ•œ๊ตญ์–ด ๋˜๋Š” ์˜์–ด)
74
+ 2. ํ•œ๊ตญ์–ด ํ”„๋กฌํ”„ํŠธ๋Š” ์ž๋™์œผ๋กœ ๋ฒˆ์—ญ๋จ
75
+ 3. ํ”„๋กฌํ”„ํŠธ๊ฐ€ "wbgmsst, 3D, [ํ”„๋กฌํ”„ํŠธ], white background" ํ˜•์‹์œผ๋กœ ํฌ๋งท๋จ
76
+ 4. ๋ชจ๋ธ์ด ์ง€์ •๋œ ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
77
+ 5. ์ด๋ฏธ์ง€๊ฐ€ ํ‘œ์‹œ๋˜๊ณ  ๊ฐค๋Ÿฌ๋ฆฌ์— ์ €์žฅ๋จ
78
+
79
+ ### ํŠน๋ณ„ ๊ธฐ๋Šฅ:
80
+ - **ํ•œ๊ตญ์–ด ์ง€์›**: ํ•œ๊ตญ์–ด๋กœ ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ์ž๋™์œผ๋กœ ์˜์–ด๋กœ ๋ฒˆ์—ญ๋˜์–ด ์ฒ˜๋ฆฌ
81
+ - **๋น ๋ฅธ ์ƒ์„ฑ**: Hyper-SD LoRA๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ 8๋‹จ๊ณ„๋งŒ์œผ๋กœ๋„ ๊ณ ํ’ˆ์งˆ ์ด๋ฏธ์ง€ ์ƒ์„ฑ
82
+ - **๊ฐค๋Ÿฌ๋ฆฌ**: ๋‹ค์–‘ํ•œ ์Šคํƒ€์ผ์˜ ์ƒ˜ํ”Œ ์ด๋ฏธ์ง€๋ฅผ ์ฐธ๊ณ ํ•  ์ˆ˜ ์žˆ๋Š” ๊ฐค๋Ÿฌ๋ฆฌ ์ œ๊ณต
83
+ - **์‹œ๋“œ ์ œ์–ด**: ๋™์ผํ•œ ์ด๋ฏธ์ง€๋ฅผ ์žฌ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ๋„๋ก ์‹œ๋“œ ๊ฐ’ ์ œ์–ด ๊ฐ€๋Šฅ