# Hi3DGen

**Repository Path**: ByteDance/Hi3DGen

## Basic Information

- **Project Name**: Hi3DGen
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hi3DGen: High-fidelity 3D Geometry Generation from Images via Normal Bridging

<div class="is-size-5 publication-authors">
  <span class="author-block"><a href="https://github.com/hugoycj">Chongjie Ye</a><sup>1,2*</sup>,</span>
  <span class="author-block"><a href="https://yushuang-wu.github.io">Yushuang Wu</a><sup>2*</sup>,</span>
  <span class="author-block"><a href="" onclick="return false;">Ziteng Lu</a><sup>1</sup>,</span>
  <span class="author-block"><a href="https://scholar.google.com/citations?hl=en&user=HA5zLp4AAAAJ">Jiahao Chang</a><sup>1</sup>,</span>
  <span class="author-block"><a href="" onclick="return false;">Xiaoyang Guo</a><sup>2</sup>,</span>
  <span class="author-block"><a href="https://scholar.google.com/citations?hl=en&user=qn61WqgAAAAJ">Jiaqing Zhou</a><sup>2</sup>,</span>
  <span class="author-block"><a href="https://sites.google.com/view/fromandto">Hao Zhao</a><sup>3</sup>,</span>
  <span class="author-block"><a href="https://gaplab.cuhk.edu.cn">Xiaoguang Han</a><sup>1#</sup></span>
</div>

<h3 align="center">ICCV 2025</h3>

<div class="is-size-5 publication-authors">
  <span class="author-block"><sup>1</sup>The Chinese University of Hong Kong, Shenzhen,&nbsp;&nbsp;</span>
  <span class="author-block"><sup>2</sup>ByteDance,&nbsp;&nbsp;</span>
  <span class="author-block"><sup>3</sup>AIR, Tsinghua University</span>
</div>

![teaser-1](assets/teaser.gif)

<div align="center">

[![Website](https://raw.githubusercontent.com/prs-eth/Marigold/main/doc/badges/badge-website.svg)](https://stable-x.github.io/Hi3DGen/) 
[![Paper](https://img.shields.io/badge/arXiv-PDF-b31b1b)](https://arxiv.org/abs/2503.22236) 
[![Online Demo](https://img.shields.io/badge/🤗%20Hugging%20Face%20-Space-yellow)](https://huggingface.co/spaces/Stable-X/Hi3DGen) 
[![Hugging Face Model](https://img.shields.io/badge/🤗%20Hugging%20Face%20-Model-green)](https://huggingface.co/Stable-X/trellis-normal-v0-1) 
 </div>

Hi3DGen target at generating high-fidelity 3D geometry from images using normal maps as an intermediate representation. The framework addresses limitations in existing methods that struggle to reproduce fine-grained geometric details from 2D inputs.

## Installation
Clone the repo:
```bash
git clone --recursive https://github.com/ByteDance/Hi3DGen.git
cd Hi3DGen
```

Create a conda environment (optional):
```bash
conda create -n stablex python=3.10
conda activate stablex
```

Install dependencies:
```bash
# pytorch (select correct CUDA version)
pip install torch==2.4.0 torchvision==0.19.0 --index-url https://download.pytorch.org/whl/{your-cuda-version}
pip install spconv-cu{your-cuda-version}==2.3.6 xformers==0.0.27.post2
# other dependencies
pip install -r requirements.txt
```

## Local Demo 🤗
Run by:
```bash
python app.py
```

## Citation
If you find this work helpful, please consider citing our paper:
```
@article{ye2025hi3dgen,
  title={Hi3DGen: High-fidelity 3D Geometry Generation from Images via Normal Bridging},
  author={Ye, Chongjie and Wu, Yushuang and Lu, Ziteng and Chang, Jiahao and Guo, Xiaoyang and Zhou, Jiaqing and Zhao, Hao and Han, Xiaoguang},
  journal={arXiv preprint arXiv:2503.22236}, 
  year={2025}
}
```