{"id":19137487,"url":"https://github.com/dsaurus/threestudio-mvdream","last_synced_at":"2025-05-06T20:12:32.520Z","repository":{"id":210061402,"uuid":"725605500","full_name":"DSaurus/threestudio-mvdream","owner":"DSaurus","description":"MVDream extension of threestudio.","archived":false,"fork":false,"pushed_at":"2023-12-20T06:50:34.000Z","size":44,"stargazers_count":42,"open_issues_count":2,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T14:57:47.351Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DSaurus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-11-30T13:53:24.000Z","updated_at":"2025-03-25T14:40:28.000Z","dependencies_parsed_at":"2025-04-19T09:31:39.123Z","dependency_job_id":"f3bf3205-1674-4a97-a8e9-2b8620661fb1","html_url":"https://github.com/DSaurus/threestudio-mvdream","commit_stats":null,"previous_names":["dsaurus/threestudio-mvdream"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSaurus%2Fthreestudio-mvdream","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSaurus%2Fthreestudio-mvdream/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSaurus%2Fthreestudio-mvdream/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSaurus%2Fthreestudio-mvdream/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DSaurus","download_url":"https://codeload.github.com/DSaurus/threestudio-mvdream/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252761236,"owners_count":21800127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T06:38:33.805Z","updated_at":"2025-05-06T20:12:32.465Z","avatar_url":"https://github.com/DSaurus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# threestudio-mvdream\n![mvdream](https://github.com/DSaurus/threestudio-mvdream/assets/24589363/b21e2a80-7ea9-4add-890e-0395b91aa5af)\n\nThe MVDream extension for threestudio. The original implementation can be found at https://github.com/bytedance/MVDream-threestudio. We thank them for their contribution to the 3D generation community. To use it, please install [threestudio](https://github.com/threestudio-project/threestudio) first and then install this extension in threestudio `custom` directory.\n\n# Installation\n```\ncd custom\ngit clone https://github.com/DSaurus/threestudio-mvdream.git\ncd threestudio-mvdream\n\n# First install xformers (https://github.com/facebookresearch/xformers#installing-xformers)\n# cuda 11.8 version\npip3 install -U xformers --index-url https://download.pytorch.org/whl/cu118\n# cuda 12.1 version\n# pip3 install -U xformers --index-url https://download.pytorch.org/whl/cu121\n\n# Then install other dependencies\npip install -r requirements.txt\n```\n\n# Quick Start\n```\n# MVDream without shading (memory efficient)\npython launch.py --config custom/threestudio-mvdream/configs/mvdream-sd21.yaml --train --gpu 0 system.prompt_processor.prompt=\"an astronaut riding a horse\"\n\n# MVDream with shading (used in paper)\npython launch.py --config custom/threestudio-mvdream/configs/mvdream-sd21-shading.yaml --train --gpu 0 system.prompt_processor.prompt=\"an astronaut riding a horse\"\n```\n\n# Resume from checkpoints\n```\n# resume training from the last checkpoint, you may replace last.ckpt with any other checkpoints\npython launch.py --config path/to/trial/dir/configs/parsed.yaml --train --gpu 0 resume=path/to/trial/dir/ckpts/last.ckpt\n# if the training has completed, you can still continue training for a longer time by setting trainer.max_steps\npython launch.py --config path/to/trial/dir/configs/parsed.yaml --train --gpu 0 resume=path/to/trial/dir/ckpts/last.ckpt trainer.max_steps=20000\n# you can also perform testing using resumed checkpoints\npython launch.py --config path/to/trial/dir/configs/parsed.yaml --test --gpu 0 resume=path/to/trial/dir/ckpts/last.ckpt\n# note that the above commands use parsed configuration files from previous trials\n# which will continue using the same trial directory\n# if you want to save to a new trial directory, replace parsed.yaml with raw.yaml in the command\n\n# only load weights from saved checkpoint but dont resume training (i.e. dont load optimizer state):\npython launch.py --config path/to/trial/dir/configs/parsed.yaml --train --gpu 0 system.weights=path/to/trial/dir/ckpts/last.ckpt\n```\n\n# Citing\n\nIf you find MVDream helpful, please consider citing:\n\n```\n@article{shi2023MVDream,\n  author = {Shi, Yichun and Wang, Peng and Ye, Jianglong and Mai, Long and Li, Kejie and Yang, Xiao},\n  title = {MVDream: Multi-view Diffusion for 3D Generation},\n  journal = {arXiv:2308.16512},\n  year = {2023},\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsaurus%2Fthreestudio-mvdream","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsaurus%2Fthreestudio-mvdream","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsaurus%2Fthreestudio-mvdream/lists"}