Skip to content

GaussianDreamer: Fast Generation from Text to 3D Gaussians by Bridging 2D and 3D Diffusion Models (CVPR 2024)

License

Notifications You must be signed in to change notification settings

hustvl/GaussianDreamer

Repository files navigation

block

GaussianDreamer: Fast Generation from Text to 3D Gaussians by Bridging 2D and 3D Diffusion Models (CVPR 2024)

GaussianDreamer: Fast Generation from Text to 3D Gaussians by Bridging 2D and 3D Diffusion Models

Taoran Yi1, Jiemin Fang2‡, Junjie Wang2, Guanjun Wu3, Lingxi Xie2,
Xiaopeng Zhang2,Wenyu Liu1, Qi Tian2 , Xinggang Wang1‡✉

1School of EIC, HUST  2Huawei Inc.   3School of CS, HUST  

Project lead. Corresponding author.

block In recent times, the generation of 3D assets from text prompts has shown impressive results. Both 2D and 3D diffusion models can help generate decent 3D objects based on prompts. 3D diffusion models have good 3D consistency, but their quality and generalization are limited as trainable 3D data is expensive and hard to obtain. 2D diffusion models enjoy strong abilities of generalization and fine generation, but 3D consistency is hard to guarantee. This paper attempts to bridge the power from the two types of diffusion models via the recent explicit and efficient 3D Gaussian splatting representation. A fast 3D object generation framework, named as GaussianDreamer, is proposed, where the 3D diffusion model provides priors for initialization and the 2D diffusion model enriches the geometry and appearance. Operations of noisy point growing and color perturbation are introduced to enhance the initialized Gaussians. Our GaussianDreamer can generate a high-quality 3D instance or 3D avatar within 15 minutes on one GPU, much faster than previous methods, while the generated instances can be directly rendered in real time. block

🦾 Updates

  • 6/26/2024: We have released GaussianDreamerPro with highly enhanced quality which can be seamlessly integrated into animation/simulation pipelines🚀.
  • 5/14/2024: We update the results of our method on T3Bench, refer to arxiv paper for details.
  • 3/8/2024: We also provide a GaussianDreamer extension for threestudio. Thanks for the contribution of Xinhua Cheng.
  • 2/27/2024: Accepted by CVPR 2024.
  • 12/6/2023: Update arxiv paper.
  • 11/27/2023: Update colab and huggingface demo.
  • 11/27/2023: Release the results initialized using point clouds with ground. And now we support importing the generated 3D assets into the Unity game engine with the help of UnityGaussianSplatting. See the Project Page for details.
  • 10/24/2023: Release the results initialized using SMPL. See the Project Page for details.
  • 10/21/2023: Fixed some installation issues, thanks to Sikuang Li, Tawfik Boujeh, and ashawkey. You can view the detailed information in branch diff.
  • 10/16/2023: The rough code has been released, and there may still be some issues. Please feel free to raise issues.

😀 Demo

Huggingface demo:

Colab demo: Open In Colab (Thanks camenduru.)

🚀 Get Started

Installation Install 3D Gaussian Splatting and Shap-E as fellow:

pip install torch==2.0.1+cu117 torchvision==0.15.2+cu117 torchaudio==2.0.2 --index-url https://download.pytorch.org/whl/cu117
pip install ninja
pip install -r requirements.txt

git clone https://github.com/hustvl/GaussianDreamer.git 
cd GaussianDreamer

pip install ./gaussiansplatting/submodules/diff-gaussian-rasterization
pip install ./gaussiansplatting/submodules/simple-knn

git clone https://github.com/openai/shap-e.git
cd shap-e
pip install -e .

Download finetuned Shap-E by Cap3D, and put it in ./load

Quickstart

Text-to-3D Generation

python launch.py --config configs/gaussiandreamer-sd.yaml --train --gpu 0 system.prompt_processor.prompt="a fox"

# if you want to import the generated 3D assets into the Unity game engine.
python launch.py --config configs/gaussiandreamer-sd.yaml --train --gpu 0 system.prompt_processor.prompt="a fox" system.sh_degree=3 

Text-to-Avatar Generation

python launch.py --config configs/gaussiandreamer-sd.yaml --train --gpu 0 system.prompt_processor.prompt="Spiderman stands with open arms" system.load_type=1

# if you want to import the generated 3D assets into the Unity game engine.
python launch.py --config configs/gaussiandreamer-sd.yaml --train --gpu 0 system.prompt_processor.prompt="Spiderman stands with open arms" system.load_type=1 system.sh_degree=3 

Application

Import the generated 3D assets into the Unity game engine to become materials for games and designs with the help of UnityGaussianSplatting. block

🏁 Evaluation

We evaluate our model using the ViT similarity and T3Bench, and the results are as follows.

ViT similarity

Methods ViT-L/14 $\uparrow$ ViT-bigG-14 $\uparrow$ Generation Time $\downarrow$
Shap-E 20.51 32.21 6 seconds
DreamFusion 23.60 37.46 1.5 hours
ProlificDreamer 27.39 42.98 10 hours
Instant3D 26.87 41.77 20 seconds
Ours 27.23 $\pm$ 0.06 41.88 $\pm$ 0.04 15 minutes
Methods Time Single Obj. Single w/ Surr. Multi Obj. Average
SJC -- 24.7 19.8 11.7 18.7
DreamFusion 6 hours 24.4 24.6 16.1 21.7
Fantasia3D 6 hours 26.4 27.0 18.5 24.0
LatentNeRF 15 minutes 33.1 30.6 20.6 28.1
Magic3D 5.3 hours 37.0 35.4 25.7 32.7
ProlificDreamer 10 hours 49.4 44.8 35.8 43.3
Ours 15 minutes 54.0 48.6 34.5 45.7

📑 Citation

If you find this repository/work helpful in your research, welcome to cite the paper and give a ⭐. Some source code of ours is borrowed from Threestudio, 3DGS, depth-diff-gaussian-rasterization. We sincerely appreciate the excellent works of these authors.

@inproceedings{yi2023gaussiandreamer,
  title={GaussianDreamer: Fast Generation from Text to 3D Gaussians by Bridging 2D and 3D Diffusion Models},
  author={Yi, Taoran and Fang, Jiemin and Wang, Junjie and Wu, Guanjun and Xie, Lingxi and Zhang, Xiaopeng and Liu, Wenyu and Tian, Qi and Wang, Xinggang},
  year = {2024},
  booktitle = {CVPR}
}