DreamScene

DreamScene-Project更新放缓

基于 3D 高斯泼溅的文本生成 3D 场景工具,通过 Formation Pattern Sampling 从文字描述直接构建可渲染的三维场景,适合做 3D AIGC 内容创作。

[ECCV2024] DreamScene: 3D Gaussian-based Text-to-3D Scene Generation via Formation Pattern Sampling

暂无版本232star19fork同步于 2026-11-07 07:32 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/DreamScene-Project/DreamScene.git
cd DreamScene
conda create -n dreamscene python=3.10
conda activate dreamscene
pip install -r requirements.txt -f https://download.pytorch.org/whl/cu118/torch_stable.html
硬件要求按 README 说明

README 说明整场景生成若显存超过 40G 可单卡运行,否则建议双卡;单物体生成未说明显存要求,未提及 CPU 运行及 GPU 厂商型号。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于 3D 高斯与 Formation Pattern Sampling 的文本到 3D 场景生成官方实现

基于 3D 高斯泼溅的文本生成 3D 场景工具,通过 Formation Pattern Sampling 从文字描述直接构建可渲染的三维场景,适合做 3D AIGC 内容创作。

核心能力

  • 用 Formation Pattern Sampling 从文本生成 3D 高斯场景
  • 支持单物体与整场景两种生成模式
  • 提供室内、室外场景的示例配置直接运行
  • 集成 Point-E 并可选微调权重提升初始化
  • 基于 diff-gaussian-rasterization 渲染高斯

容易踩的坑

需额外克隆并安装 comp-diff-gaussian-rasterization 和 simple-knn 两个 CUDA 扩展;需按官方 INSTALL.md 单独安装 pytorch3d;需克隆 Cap3D 并安装其中的 point-e,还要下载 Point-E 微调权重到 point_e_model_cache 并改配置 init_guided。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    DreamScene

    Haoran Li, Haolin Shi, Wenli Zhang, Wenjun Wu, Yong Liao, Lin Wang, Lik-hang Lee, Pengyuan Zhou,Yuli Tian, Kun Lan,Pan Hui,Yuyang Wang,Yonghui Wang,

    This repository contains the official implementation for DreamScene: 3D Gaussian-based Text-to-3D Scene Generation via Formation Pattern Sampling.
    We extend it in DreamScene: 3D Gaussian-based End-to-end Text-to-3D Scene Generation, with a fully automatic pipeline.

    ECCV: Project Page arXiv

    TPAMI: Extension Page arXiv

    Note: We compress these motion pictures for faster previewing.

    News

    • 2024-07-01: Our paper is accepted by ECCV2024 and to be published!
    • 2025-07-29: We released the webpage for our ECCV extension!
    • 2025-09-28: Our extended paper has been accepted by TPAMI and will be published soon!

    TODO

    • Release the code of Formation Pattern Sampling (FPS) for single object.
    • Release the code of entire DreamScene for generating dream scenes and our demo video.
    • More samples, and tools for generating layout interactively.
    • Release the code of the improved extension version with full pipeline.

    Getting Start!

    Requirments

    git clone https://github.com/DreamScene-Project/DreamScene.git
    cd DreamScene
    
    conda create -n dreamscene python=3.10
    conda activate dreamscene
    
    pip install -r requirements.txt -f https://download.pytorch.org/whl/cu118/torch_stable.html
    
    git clone --recursive https://github.com/DreamScene-Project/comp-diff-gaussian-rasterization.git
    git clone https://github.com/YixunLiang/simple-knn.git
    
    pip install comp-diff-gaussian-rasterization/
    pip install simple-knn/
    
    # Follow https://github.com/facebookresearch/pytorch3d/blob/main/INSTALL.md
    pip install "git+https://github.com/facebookresearch/pytorch3d.git@stable"
    
    # Install point-e
    git clone https://github.com/crockwell/Cap3D.git
    cd Cap3D/text-to-3D/point-e/
    pip install -e .
    
    mkdir point_e_model_cache
    # Optional: Initialize with better point-e
    wget https://huggingface.co/datasets/tiange/Cap3D/resolve/main/misc/our_finetuned_models/pointE_finetuned_with_825kdata.pth
    mv pointE_finetuned_with_825kdata.pth point_e_model_cache/
    # Modify the parameter init_guided in the configuration file to pointe_825k
    
    # or
    
    wget https://huggingface.co/datasets/tiange/Cap3D/resolve/main/misc/our_finetuned_models/pointE_finetuned_with_330kdata.pth
    mv pointE_finetuned_with_330kdata.pth point_e_model_cache/
    # Modify the parameter init_guided in the configuration file to pointe_330k
    

    Generate Single Object

    python main.py --object --config configs/objects/sample.yaml
    

    Generate Entire Scenes

    If your device has more than 40G VRAM, you can run it with a single card. Otherwise, it is recommended to use dual cards.

    CUDA_VISIBLE_DEVICES=0,1 python main.py --config configs/scenes/sample_indoor.yaml
    
    CUDA_VISIBLE_DEVICES=2,3 python main.py --config configs/scenes/sample_outdoor.yaml
    

    Acknowledgement

    This work is built on many amazing research works and open-source projects, thanks a lot to all the authors for sharing!

    Citation

    If you find it useful in your research, please consider citing our papers DreamScene and its extension paper as follows:

    @inproceedings{li2024dreamscene,
      title={Dreamscene: 3d gaussian-based text-to-3d scene generation via formation pattern sampling},
      author={Li, Haoran and Shi, Haolin and Zhang, Wenli and Wu, Wenjun and Liao, Yong and Wang, Lin and Lee, Lik-hang and Zhou, Peng Yuan},
      booktitle={European Conference on Computer Vision},
      pages={214--230},
      year={2024},
      organization={Springer}
    }
    
    @article{li2025dreamscene,
      title={DreamScene: 3D Gaussian-based End-to-end Text-to-3D Scene Generation},
      author={Li, Haoran and Tian, Yuli and Lan, Kun and Liao, Yong and Wang, Lin and Hui, Pan and Zhou, Peng Yuan},
      journal={arXiv preprint arXiv:2507.13985},
      year={2025}
    }