Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/buaacyw/meshanything
From anything to mesh like human artists. Official impl. of "MeshAnything: Artist-Created Mesh Generation with Autoregressive Transformers"
https://github.com/buaacyw/meshanything
3d auto-regressive-model generative-ai generative-model large-language-models mesh mesh-generation point-cloud transformers
Last synced: 3 days ago
JSON representation
From anything to mesh like human artists. Official impl. of "MeshAnything: Artist-Created Mesh Generation with Autoregressive Transformers"
- Host: GitHub
- URL: https://github.com/buaacyw/meshanything
- Owner: buaacyw
- License: other
- Created: 2024-06-16T16:02:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-08-05T17:08:25.000Z (5 months ago)
- Last Synced: 2024-11-28T07:02:45.742Z (24 days ago)
- Topics: 3d, auto-regressive-model, generative-ai, generative-model, large-language-models, mesh, mesh-generation, point-cloud, transformers
- Language: Python
- Homepage: https://buaacyw.github.io/mesh-anything/
- Size: 79.8 MB
- Stars: 2,054
- Watchers: 32
- Forks: 91
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
MeshAnything:
Artist-Created Mesh Generation
with Autoregressive Transformers
Yiwen Chen1,2*,
Tong He2†,
Di Huang2,
Weicai Ye2,
Sijin Chen3,
Jiaxiang Tang4
Xin Chen5,
Zhongang Cai6,
Lei Yang6,
Gang Yu7,
Guosheng Lin1†,
Chi Zhang8†
*Work done during a research internship at Shanghai AI Lab.
†Corresponding authors.
1S-Lab, Nanyang Technological University,
2Shanghai AI Lab,
3Fudan University,
4Peking University,
5University of Chinese Academy of Sciences,
6SenseTime Research,
7Stepfun,
8Westlake University
## Release
- [6/17] 🔥🔥 Try our newly released **[MeshAnything V2](https://github.com/buaacyw/MeshAnythingV2)**. Maximum face number is increased to **1600** in V2 with better performance.
- [6/17] We released the 350m version of **MeshAnything**.
## Contents
- [Release](#release)
- [Contents](#contents)
- [Installation](#installation)
- [Usage](#usage)
- [Important Notes](#important-notes)
- [TODO](#todo)
- [Acknowledgement](#acknowledgement)
- [Star History](#star-history)
- [BibTeX](#bibtex)
## Installation
Our environment has been tested on Ubuntu 22, CUDA 11.8 with A100, A800 and A6000.
1. Clone our repo and create conda environment
```
git clone https://github.com/buaacyw/MeshAnything.git && cd MeshAnything
conda create -n MeshAnything python==3.10.13 -y
conda activate MeshAnything
pip install torch==2.1.1 torchvision==0.16.1 torchaudio==2.1.1 --index-url https://download.pytorch.org/whl/cu118
pip install -r requirements.txt
pip install flash-attn --no-build-isolation
```
or
```shell
pip install git+https://github.com/buaacyw/MeshAnything.git
```
And directly use in your code as
```
import MeshAnything
```
## Usage
### Local Gradio Demo 
```
python app.py
```
### Mesh Command line inference
```
# folder input
python main.py --input_dir examples --out_dir mesh_output --input_type mesh
# single file input
python main.py --input_path examples/wand.obj --out_dir mesh_output --input_type mesh
# Preprocess with Marching Cubes first
python main.py --input_dir examples --out_dir mesh_output --input_type mesh --mc
```
### Point Cloud Command line inference
```
# Note: if you want to use your own point cloud, please make sure the normal is included.
# The file format should be a .npy file with shape (N, 6), where N is the number of points. The first 3 columns are the coordinates, and the last 3 columns are the normal.
# inference for folder
python main.py --input_dir pc_examples --out_dir pc_output --input_type pc_normal
# inference for single file
python main.py --input_path pc_examples/mouse.npy --out_dir pc_output --input_type pc_normal
```
## Important Notes
- It takes about 7GB and 30s to generate a mesh on an A6000 GPU.
- The input mesh will be normalized to a unit bounding box. The up vector of the input mesh should be +Y for better results.
- Limited by computational resources, MeshAnything is trained on meshes with fewer than 800 faces and cannot generate meshes with more than 800 faces. The shape of the input mesh should be sharp enough; otherwise, it will be challenging to represent it with only 800 faces. Thus, feed-forward 3D generation methods may often produce bad results due to insufficient shape quality. We suggest using results from 3D reconstruction, scanning and SDS-based method (like [DreamCraft3D](https://github.com/deepseek-ai/DreamCraft3D)) as the input of MeshAnything.
- Please refer to https://huggingface.co/spaces/Yiwen-ntu/MeshAnything/tree/main/examples for more examples.
## TODO
The repo is still being under construction, thanks for your patience.
- [ ] Release of training code.
- [ ] Release of larger model.
## Acknowledgement
Our code is based on these wonderful repos:
* [MeshGPT](https://nihalsid.github.io/mesh-gpt/)
* [meshgpt-pytorch](https://github.com/lucidrains/meshgpt-pytorch)
* [Michelangelo](https://github.com/NeuralCarver/Michelangelo)
* [transformers](https://github.com/huggingface/transformers)
* [vector-quantize-pytorch](https://github.com/lucidrains/vector-quantize-pytorch)
## Star History
[](https://star-history.com/#buaacyw/MeshAnything&Date)
## BibTeX
```
@misc{chen2024meshanything,
title={MeshAnything: Artist-Created Mesh Generation with Autoregressive Transformers},
author={Yiwen Chen and Tong He and Di Huang and Weicai Ye and Sijin Chen and Jiaxiang Tang and Xin Chen and Zhongang Cai and Lei Yang and Gang Yu and Guosheng Lin and Chi Zhang},
year={2024},
eprint={2406.10163},
archivePrefix={arXiv},
primaryClass={cs.CV}
}
```