Giter Club home page Giter Club logo

luciddreamer's Introduction

๐Ÿ˜ด LucidDreamer: Domain-free Generation of 3D Gaussian Splatting Scenes ๐Ÿ˜ด

Project ArXiv Github X LICENSE Open In Colab Open in Spaces

demo_trim2.mp4
*Denotes equal contribution.


โšก Usage

Prerequisite

  • Linux: Ubuntu>18.04

Install

conda create -n lucid python=3.9
conda activate lucid
pip install peft diffusers scipy numpy imageio[ffmpeg] opencv-python Pillow open3d torchvision gradio
pip install torch==2.0.1 timm==0.6.7 # ZoeDepth
pip install plyfile==0.8.1 # Gaussian splatting

cd submodules/depth-diff-gaussian-rasterization-min
python setup.py install
cd ../simple-knn
python setup.py install
cd ../..

Run with your own samples

# Default Example
python run.py

To run with your own inputs and prompts, attach following arguments after run.py.

  • -img : path of input image.
  • -t : text prompt. Can be either path to txt file or the text iteslf.
  • -nt : negative text prompt. Can be either path to txt file or the text iteslf.
  • -cg : camera extrinsic path for generating scenes. Can be one of "Rotate_360", "LookAround", or "LookDown".
  • -cr : camera extrinsic path for rendering videos. Can be one of "Back_and_forth", "LLFF", or "Headbanging".
  • --seed : manual seed for Stable Diffusion inpainting.
  • --diff_steps : number of denoising steps for Stable Diffusion inpainting. Default is 50.
  • -s : path to save results.

๐Ÿšฉ Updates

  • โœ… December 7, 2023: Colab implementation is now available thanks to @camenduru!
  • โœ… December 6, 2023: Code release!
  • โœ… November 22, 2023: We have released our paper, LucidDreamer on arXiv.

๐ŸŒ Citation

Please cite us if you find our project useful!

@article{chung2023luciddreamer,
    title={LucidDreamer: Domain-free Generation of 3D Gaussian Splatting Scenes},
    author={Chung, Jaeyoung and Lee, Suyoung and Nam, Hyeongjin and Lee, Jaerin and Lee, Kyoung Mu},
    journal={arXiv preprint arXiv:2311.13384},
    year={2023}
}

๐Ÿค— Acknowledgement

We deeply appreciate ZoeDepth, Stability AI, and Runway for their models.

๐Ÿ“ง Contact

If you have any questions, please email [email protected], [email protected].

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.