Nekochu commited on
Commit
8792f7b
Β·
verified Β·
1 Parent(s): 5818455

edit readme color

Browse files
Files changed (1) hide show
  1. README.md +83 -83
README.md CHANGED
@@ -1,83 +1,83 @@
1
- ---
2
- title: TEXTure CPU Lite
3
- emoji: 🎨
4
- colorFrom: purple
5
- colorTo: blue
6
- sdk: gradio
7
- sdk_version: 6.2.0
8
- app_file: app.py
9
- pinned: false
10
- license: mit
11
- ---
12
-
13
- # TEXTure CPU Lite - Text-Guided 3D Texturing
14
-
15
- Generate **proper UV texture maps** for 3D meshes using text prompts.
16
- Uses SD-2-Depth (same as original TEXTure paper) for depth-conditioned generation and xatlas for UV unwrapping.
17
-
18
- ## Features
19
-
20
- - **Proper UV Texture Output**: Creates UV atlas that can be applied to the mesh
21
- - **SD-2-Depth**: Native depth conditioning (same model as original TEXTure)
22
- - **OBJ Export**: Outputs OBJ + MTL + texture PNG ready to use
23
- - **xatlas UV Unwrapping**: Automatic UV coordinate generation
24
-
25
- ## How it works
26
-
27
- 1. Upload a 3D mesh (.obj, .stl, .ply, .glb)
28
- 2. Enter a text prompt describing the desired texture
29
- 3. xatlas generates UV coordinates
30
- 4. Depth is rendered from multiple viewpoints
31
- 5. SD-2-Depth generates textures conditioned on depth
32
- 6. Textures are projected back to UV space
33
- 7. Download textured mesh (OBJ + MTL + PNG)
34
-
35
- ## Models Used
36
-
37
- | Component | Model | Size |
38
- |-----------|-------|------|
39
- | SD-2-Depth | radames/stable-diffusion-2-depth-img2img | ~5GB |
40
-
41
- **Same architecture as original TEXTure paper** (SD-2-Depth) - has native depth conditioning built-in.
42
- Uses public community copy since official `stabilityai/stable-diffusion-2-depth` is gated.
43
-
44
- **Runtime:**
45
- - First run: Downloads ~5GB model (cached in `~/.cache/huggingface/`)
46
- - CPU uses INT8 quantization via `optimum.quanto` for 3-5x speedup
47
- - ONNX not supported (SD-2-Depth has 5-channel UNet)
48
-
49
- **Debug logs:** Check build logs for `[OK]`, `[ERROR]`, `[WARN]` messages if something fails.
50
-
51
- ## Performance
52
-
53
- | Device | Steps | Time per View | 4 Views Total |
54
- |--------|-------|---------------|---------------|
55
- | GPU (CUDA) | 20 | ~2-3 sec | ~12 sec |
56
- | CPU (INT8) | 10 | ~1.5 min | ~6 min |
57
- | CPU (INT8) | 20 | ~3 min | ~14 min |
58
-
59
- **Tip:** For faster results on CPU, use fewer steps (5-10) or fewer views (2-3).
60
-
61
- ## Local Development
62
-
63
- ```bash
64
- pip install -r requirements.txt
65
- python app.py
66
- ```
67
-
68
- ## Files Structure
69
-
70
- ```
71
- β”œβ”€β”€ app.py # Single-file implementation
72
- β”œβ”€β”€ requirements.txt
73
- β”œβ”€β”€ README.md
74
- └── shapes/
75
- └── bunny.obj # Sample mesh
76
- ```
77
-
78
- ## Credits
79
-
80
- - [TEXTure Paper](https://texturepaper.github.io/TEXTurePaper/) - Yael Vinker et al.
81
- - [ControlNet](https://github.com/lllyasviel/ControlNet) - Lvmin Zhang
82
- - [Stable Diffusion](https://huggingface.co/runwayml/stable-diffusion-v1-5) - RunwayML
83
- - [xatlas](https://github.com/jpcy/xatlas) - UV unwrapping
 
1
+ ---
2
+ title: TEXTure CPU Lite
3
+ emoji: 🎨
4
+ colorFrom: green
5
+ colorTo: pink
6
+ sdk: gradio
7
+ sdk_version: 6.2.0
8
+ app_file: app.py
9
+ pinned: false
10
+ license: mit
11
+ ---
12
+
13
+ # TEXTure CPU Lite - Text-Guided 3D Texturing
14
+
15
+ Generate **proper UV texture maps** for 3D meshes using text prompts.
16
+ Uses SD-2-Depth (same as original TEXTure paper) for depth-conditioned generation and xatlas for UV unwrapping.
17
+
18
+ ## Features
19
+
20
+ - **Proper UV Texture Output**: Creates UV atlas that can be applied to the mesh
21
+ - **SD-2-Depth**: Native depth conditioning (same model as original TEXTure)
22
+ - **OBJ Export**: Outputs OBJ + MTL + texture PNG ready to use
23
+ - **xatlas UV Unwrapping**: Automatic UV coordinate generation
24
+
25
+ ## How it works
26
+
27
+ 1. Upload a 3D mesh (.obj, .stl, .ply, .glb)
28
+ 2. Enter a text prompt describing the desired texture
29
+ 3. xatlas generates UV coordinates
30
+ 4. Depth is rendered from multiple viewpoints
31
+ 5. SD-2-Depth generates textures conditioned on depth
32
+ 6. Textures are projected back to UV space
33
+ 7. Download textured mesh (OBJ + MTL + PNG)
34
+
35
+ ## Models Used
36
+
37
+ | Component | Model | Size |
38
+ |-----------|-------|------|
39
+ | SD-2-Depth | radames/stable-diffusion-2-depth-img2img | ~5GB |
40
+
41
+ **Same architecture as original TEXTure paper** (SD-2-Depth) - has native depth conditioning built-in.
42
+ Uses public community copy since official `stabilityai/stable-diffusion-2-depth` is gated.
43
+
44
+ **Runtime:**
45
+ - First run: Downloads ~5GB model (cached in `~/.cache/huggingface/`)
46
+ - CPU uses INT8 quantization via `optimum.quanto` for 3-5x speedup
47
+ - ONNX not supported (SD-2-Depth has 5-channel UNet)
48
+
49
+ **Debug logs:** Check build logs for `[OK]`, `[ERROR]`, `[WARN]` messages if something fails.
50
+
51
+ ## Performance
52
+
53
+ | Device | Steps | Time per View | 4 Views Total |
54
+ |--------|-------|---------------|---------------|
55
+ | GPU (CUDA) | 20 | ~2-3 sec | ~12 sec |
56
+ | CPU (INT8) | 10 | ~1.5 min | ~6 min |
57
+ | CPU (INT8) | 20 | ~3 min | ~14 min |
58
+
59
+ **Tip:** For faster results on CPU, use fewer steps (5-10) or fewer views (2-3).
60
+
61
+ ## Local Development
62
+
63
+ ```bash
64
+ pip install -r requirements.txt
65
+ python app.py
66
+ ```
67
+
68
+ ## Files Structure
69
+
70
+ ```
71
+ β”œβ”€β”€ app.py # Single-file implementation
72
+ β”œβ”€β”€ requirements.txt
73
+ β”œβ”€β”€ README.md
74
+ └── shapes/
75
+ └── bunny.obj # Sample mesh
76
+ ```
77
+
78
+ ## Credits
79
+
80
+ - [TEXTure Paper](https://texturepaper.github.io/TEXTurePaper/) - Yael Vinker et al.
81
+ - [ControlNet](https://github.com/lllyasviel/ControlNet) - Lvmin Zhang
82
+ - [Stable Diffusion](https://huggingface.co/runwayml/stable-diffusion-v1-5) - RunwayML
83
+ - [xatlas](https://github.com/jpcy/xatlas) - UV unwrapping