TrNi commited on
Commit
ef15eda
Β·
verified Β·
1 Parent(s): ad31ead

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -11
README.md CHANGED
@@ -13,13 +13,13 @@ library_name: torchao
13
  pipeline_tag: text-to-3d
14
  ---
15
 
16
- # πŸš€ First INT4 Quantized Cube3D β€” Run on Half the VRAM
17
 
18
  ![](https://img.shields.io/badge/VRAM_-14.3_GB_(44%25↓)-brightgreen)
19
- ![](https://img.shields.io/badge/Loading-88%25_faster-blue)
20
- ![](https://img.shields.io/badge/Latency-same-green)
21
 
22
- Presenting the **first INT4 quantized version** of [Cube3D v0.5](https://huggingface.co/Roblox/cube3d-v0.5), a text-to-3D mesh generative model. Quantized via **RTN W4A16** (group_size=128) using [torchao](https://github.com/pytorch/ao), it cuts peak VRAM from **25.4 GB β†’ 14.3 GB (44%↓)** while maintaining the same inference speed and comparable shape fidelity β€” enabling 3D shape generation on much smaller, more accessible GPUs.
23
 
24
  | | BF16 + Engine | BF16 + EngineFast | **INT4 + EngineFast** |
25
  |---|:-:|:-:|:-:|
@@ -27,7 +27,8 @@ Presenting the **first INT4 quantized version** of [Cube3D v0.5](https://hugging
27
  | πŸ“¦ Setup time | 19.4 s | 206.9 s | **25.1 s (88%↓)** |
28
  | ⏱️ Latency | 90.9 s | 15.0 s | **14.2 s** |
29
 
30
- > πŸ’‘ The 44% VRAM reduction means this model now fits on a single 16 GB GPU (e.g. NVIDIA L4, A10 etc.), bringing high-quality text-to-3D generation to individual researchers and end-user hardware.
 
31
 
32
  ### Original BF16 vs Quantized INT4 Comparisons:
33
  ##### A. Easy Categories (7)
@@ -38,7 +39,7 @@ Presenting the **first INT4 quantized version** of [Cube3D v0.5](https://hugging
38
  ![Complex categories](assets/complex.gif)
39
 
40
 
41
- # Cube3D v0.5 β€” RTN W4A16 INT4 (torchao)
42
 
43
  Post-training quantized version of [Roblox/cube3d-v0.5](https://huggingface.co/Roblox/cube3d-v0.5), a text-to-3D mesh generative model.
44
  Quantization method: **RTN W4A16**, group_size=128, via [torchao](https://github.com/pytorch/ao) `int4_weight_only`.
@@ -52,16 +53,15 @@ Quantization method: **RTN W4A16**, group_size=128, via [torchao](https://github
52
  | `open_model_v0.5.yaml` | tiny | Model architecture config |
53
  | `quant_config.json` | tiny | Quantization metadata |
54
 
55
- The BF16 GPT weights (`shape_gpt.safetensors`) are **not** included here β€” they live in the parent repo and are only needed to reconstruct the model skeleton for loading.
56
 
57
- ## Benchmark (NVIDIA A100-SXM4-40GB, 15-categories)
58
 
59
  ### Shape Quality (Chamfer Distance, 15 categories, 170 prompts):
60
 
61
- Median CD: 67.9 Γ— 10⁻³
62
 
63
  Best categories: `vehicle_land` (41.4), `geometric_primitive` (46.5), `animal_wild` (53.8).
64
- Complex categories: `symmetry_topology` (205.8), `abstract_mathematical` (167.9) β€” high variance: RTN INT4 rounding hurts topologically complex shapes.
65
 
66
 
67
  | Category | Mean | Std | n |
@@ -94,7 +94,7 @@ torchaudio==2.10.0
94
  torchao==0.10.0
95
  ```
96
 
97
- The `.pt` file is a torchao pickle, torchao enables kernel-supported INT4 inference.
98
 
99
  ## Usage
100
  Please see the Google Colab tutorial.
 
13
  pipeline_tag: text-to-3d
14
  ---
15
 
16
+ # πŸš€ First INT4 Quantized Cube3D - Run on Half the VRAM
17
 
18
  ![](https://img.shields.io/badge/VRAM_-14.3_GB_(44%25↓)-brightgreen)
19
+ ![](https://img.shields.io/badge/Loading-88%25_Faster-blue)
20
+ ![](https://img.shields.io/badge/Latency-Same-green)
21
 
22
+ Presenting the **first INT4 quantized version** of [Cube3D v0.5](https://huggingface.co/Roblox/cube3d-v0.5), a text-to-3D mesh generative model. Quantized via **RTN W4A16** (group_size=128) using [torchao](https://github.com/pytorch/ao), it cuts peak VRAM from **25.4 GB β†’ 14.3 GB (44%↓)** while maintaining the same inference speed and comparable shape fidelity - enabling 3D shape generation on much smaller, more accessible GPUs.
23
 
24
  | | BF16 + Engine | BF16 + EngineFast | **INT4 + EngineFast** |
25
  |---|:-:|:-:|:-:|
 
27
  | πŸ“¦ Setup time | 19.4 s | 206.9 s | **25.1 s (88%↓)** |
28
  | ⏱️ Latency | 90.9 s | 15.0 s | **14.2 s** |
29
 
30
+ <mark>πŸ’‘ The 44% VRAM reduction means this model now fits on a single 16 GB GPU (e.g. NVIDIA L4, A10, A2 etc.), bringing high-quality text-to-3D generation to individual researchers and end-user hardware.
31
+ </mark>
32
 
33
  ### Original BF16 vs Quantized INT4 Comparisons:
34
  ##### A. Easy Categories (7)
 
39
  ![Complex categories](assets/complex.gif)
40
 
41
 
42
+ # Cube3D v0.5 - RTN W4A16 INT4 (torchao)
43
 
44
  Post-training quantized version of [Roblox/cube3d-v0.5](https://huggingface.co/Roblox/cube3d-v0.5), a text-to-3D mesh generative model.
45
  Quantization method: **RTN W4A16**, group_size=128, via [torchao](https://github.com/pytorch/ao) `int4_weight_only`.
 
53
  | `open_model_v0.5.yaml` | tiny | Model architecture config |
54
  | `quant_config.json` | tiny | Quantization metadata |
55
 
 
56
 
57
+ ## New Benchmarking Dataset (15-categories, 170 prompts)
58
 
59
  ### Shape Quality (Chamfer Distance, 15 categories, 170 prompts):
60
 
61
+ Median Chamfer Distance: 67.9 Γ— 10⁻³
62
 
63
  Best categories: `vehicle_land` (41.4), `geometric_primitive` (46.5), `animal_wild` (53.8).
64
+ Complex categories: `symmetry_topology` (205.8), `abstract_mathematical` (167.9) - high variance.
65
 
66
 
67
  | Category | Mean | Std | n |
 
94
  torchao==0.10.0
95
  ```
96
 
97
+ The .pt file is a torchao pickle, torchao enables kernel-supported INT4 inference.
98
 
99
  ## Usage
100
  Please see the Google Colab tutorial.