Spaces:
Build error
Build error
hanshu.yan
commited on
Commit
•
dc5113b
1
Parent(s):
2ec72fb
update readme
Browse files
README.md
CHANGED
@@ -1,80 +1,10 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
<!--
|
12 |
-
<div align="center">
|
13 |
-
<img src="figures/comparison800.gif" alt="Teaser Video">
|
14 |
-
</div>
|
15 |
-
-->
|
16 |
-
<p align="center">
|
17 |
-
<img width="800" src="figures/visual_comparisons.jpg"/>
|
18 |
-
</p>
|
19 |
-
|
20 |
-
<p align="center">
|
21 |
-
<img width="450" src="figures/scatter-comparison.png"/>
|
22 |
-
</p>
|
23 |
-
|
24 |
-
|
25 |
-
The model is released under the MIT license, which includes the source code, pretrained models, and an interactive online demo. Our goal is to empower researchers, developers, and creatives to push the boundaries of what's possible in 3D generative AI and 3D content creation.
|
26 |
-
|
27 |
-
## Getting Started
|
28 |
-
### Installation
|
29 |
-
- Python >= 3.8
|
30 |
-
- Install CUDA if available
|
31 |
-
- Install PyTorch according to your platform: [https://pytorch.org/get-started/locally/](https://pytorch.org/get-started/locally/) **[Please make sure that the locally-installed CUDA major version matches the PyTorch-shipped CUDA major version. For example if you have CUDA 11.x installed, make sure to install PyTorch compiled with CUDA 11.x.]**
|
32 |
-
- Update setuptools by `pip install --upgrade setuptools`
|
33 |
-
- Install other dependencies by `pip install -r requirements.txt`
|
34 |
-
|
35 |
-
### Manual Inference
|
36 |
-
```sh
|
37 |
-
python run.py examples/chair.png --output-dir output/
|
38 |
-
```
|
39 |
-
This will save the reconstructed 3D model to `output/`. You can also specify more than one image path separated by spaces. The default options takes about **6GB VRAM** for a single image input.
|
40 |
-
|
41 |
-
For detailed usage of this script, use `python run.py --help`.
|
42 |
-
|
43 |
-
### Local Gradio App
|
44 |
-
Install Gradio:
|
45 |
-
```sh
|
46 |
-
pip install gradio
|
47 |
-
```
|
48 |
-
Start the Gradio App:
|
49 |
-
```sh
|
50 |
-
python gradio_app.py
|
51 |
-
```
|
52 |
-
|
53 |
-
## Troubleshooting
|
54 |
-
> AttributeError: module 'torchmcubes_module' has no attribute 'mcubes_cuda'
|
55 |
-
|
56 |
-
or
|
57 |
-
|
58 |
-
> torchmcubes was not compiled with CUDA support, use CPU version instead.
|
59 |
-
|
60 |
-
This is because `torchmcubes` is compiled without CUDA support. Please make sure that
|
61 |
-
|
62 |
-
- The locally-installed CUDA major version matches the PyTorch-shipped CUDA major version. For example if you have CUDA 11.x installed, make sure to install PyTorch compiled with CUDA 11.x.
|
63 |
-
- `setuptools>=49.6.0`. If not, upgrade by `pip install --upgrade setuptools`.
|
64 |
-
|
65 |
-
Then re-install `torchmcubes` by:
|
66 |
-
|
67 |
-
```sh
|
68 |
-
pip uninstall torchmcubes
|
69 |
-
pip install git+https://github.com/tatsy/torchmcubes.git
|
70 |
-
```
|
71 |
-
|
72 |
-
## Citation
|
73 |
-
```BibTeX
|
74 |
-
@article{TripoSR2024,
|
75 |
-
title={TripoSR: Fast 3D Object Reconstruction from a Single Image},
|
76 |
-
author={Tochilkin, Dmitry and Pankratz, David and Liu, Zexiang and Huang, Zixuan and and Letts, Adam and Li, Yangguang and Liang, Ding and Laforte, Christian and Jampani, Varun and Cao, Yan-Pei},
|
77 |
-
journal={arXiv preprint arXiv:2403.02151},
|
78 |
-
year={2024}
|
79 |
-
}
|
80 |
-
```
|
|
|
1 |
+
---
|
2 |
+
title: Instant Text-to-3D Mesh Demo
|
3 |
+
colorFrom: gray
|
4 |
+
colorTo: gray
|
5 |
+
sdk: gradio
|
6 |
+
sdk_version: 4.20.1
|
7 |
+
python_version: 3.10.12
|
8 |
+
app_file: app.py
|
9 |
+
pinned: false
|
10 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|