Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

8 Commits

Repository files navigation

🚀 First INT4 Quantized Efficient-Cube3D - Run on Half the VRAM

HuggingFaceOpen In Colab

Presenting the first INT4 quantized efficient version of Cube3D v0.5, a text-to-3D mesh generative model. Quantized via RTN W4A16 (group_size=128) using torchao, it cuts the model size from 7.2GB → 1.3GB (82%↓) and peak VRAM from 25.4 GB → 11.3 GB (55%↓) while maintaining the same inference speed and comparable shape fidelity - enabling 3D shape generation on much smaller, more accessible GPUs.

BF16 + EngineBF16 + EngineFastINT4 + EngineFast
💾 Model size7.17 GB7.17 GB1.26 GB (82%↓)
🎮 Peak VRAM21.7 GB25.4 GB11.3 GB (55%↓)
📦 Setup time19.4 s206.9 s6.9 s (97%↓)
⏱️ Latency90.9 s15.0 s14.2 s

💡 The 82% size reduction and 55% VRAM reduction means this model now fits on a single 15 GB GPU (e.g. NVIDIA L4, A10, A2 etc.), bringing high-quality text-to-3D generation to individual researchers and end-user hardware.

Original BF16 vs Quantized INT4 Comparisons:

A. Easy Categories (3)

Easy categories

B. Medium Categories (7)

Medium categories

C. Complex Categories (5)

Complex categories

Cube3D v0.5 - RTN W4A16 INT4 (torchao)

Post-training quantized version of Roblox/cube3d-v0.5, a text-to-3D mesh generative model.
Quantization method: RTN W4A16, group_size=128, via torchaoint4_weight_only.

What's in this repo

FileSizeDescription
shape_gpt_rtn_int4_g128.pt1.26 GBINT4 quantized GPT weights (torchao pickle)
shape_tokenizer.safetensors~1.10 GBVQ-VAE decoder — BF16, unchanged from base model
open_model_v0.5.yamltinyModel architecture config
quant_config.jsontinyQuantization metadata

New Benchmarking Dataset (15 categories, 310 prompts)

Shape Quality (Chamfer Distance, 15 categories, 310 prompts):

Median Chamfer Distance: 67.7 × 10⁻³

Best categories: animal_domestic (55.0), vehicle_land (52.2), architecture (54.0).
Complex categories: symmetry_topology (113.6), abstract_mathematical (107.2) — high variance.

CategoryMedianMeanStdn
Easy (CD × 10⁻³ < 75)
animal_domestic55.060.425.520
vehicle_land52.261.139.020
architecture54.061.729.920
Medium (CD × 10⁻³ 75–100)
musical_instrument43.179.086.320
animal_wild65.280.445.220
geometric_primitive40.881.090.220
furniture74.982.539.820
fine_detail57.783.372.820
original_visuals71.679.547.330
vehicle_air_water77.897.578.920
Complex (CD × 10⁻³ > 100)
electronics97.4126.479.320
nature_plant111.3132.069.920
tool_hardware63.7139.5193.720
abstract_mathematical107.2147.4124.220
symmetry_topology113.6176.5169.520

Requirements

torch==2.10.0+cu128
torchvision==0.25.0+cu128
torchaudio==2.10.0
torchao==0.10.0

The .pt file is a torchao pickle, torchao enables kernel-supported INT4 inference.

Usage

Please see the Colab Tutorial

Quantization details

  • Method: Round-to-nearest (RTN)
  • Precision: W4A16 - weights INT4, activations BF16
  • Quantized INT4 layers: 279 / 282
  • Skipped layers: shape_proj (in_features=16, < group size), lm_head (out=4099, output head), bbox_proj
  • Torchao Quantization Group size: 128

Citation

@article{roblox2025cube,
title={Cube: A Roblox View of 3D Intelligence},
author={Roblox},
journal={arXiv preprint arXiv:2503.15475},
year={2025}
}

About

First INT4 Quantized Cube3D Model - Run on Half the VRAM

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages