README.md

---
license: mit
library_name: transformers
pipeline_tag: image-to-3d
tags:
- Multimodal-Large-Language-Model,mesh-generation
---

# ShapeLLM-Omni: A Native Multimodal LLM for 3D Generation and Understanding

[**Paper**](https://arxiv.org/abs/2506.01853) | [**Project Page**](https://jamesyjl.github.io/ShapeLLM/) | [**Code**](https://github.com/JAMESYJL/ShapeLLM-Omni/)

Pre-trained model weights of ShapeLLM-Omni: A Native Multimodal LLM for 3D Generation and Understanding

[Junliang Ye*](https://jamesyjl.github.io/), [Zhengyi Wang*](https://thuwzy.github.io/), [Ruowen Zhao*](https://zhaorw02.github.io/), [Shenghao Xie](), [Jun Zhu](https://ml.cs.tsinghua.edu.cn/~jun/index.shtml)

<video controls autoplay src="https://cdn-uploads.huggingface.co/production/uploads/65a420cd90e65dc39a6abe9e/rgtIOzP4hpvHd1A7aQVgm.mp4"></video>

<p align="center">
  <img src="assets/head.jpg" width="600px"/>
</p>
Recently, the powerful text-to-image capabilities of GPT-4o have led to growing appreciation for native multimodal large language models. However, its multimodal capabilities remain confined to images and text. Yet beyond images, the ability to understand and generate 3D content is equally crucial. To address this gap, we propose ShapeLLM-Omni—a native 3D large language model capable of understanding and generating 3D assets and text in any sequence. First, we train a 3D vector-quantized variational autoencoder (VQ-VAE), which maps 3D objects into a discrete latent space to achieve efficient and accurate shape representation and reconstruction. Building upon the 3D-aware discrete tokens, we innovatively construct a large-scale continuous training dataset named 3D-Alpaca, encompassing generation, comprehension, and editing, thus providing rich resources for future research and training. Finally, by performing instruction-based training of the Qwen-2.5-vl-7B-Instruct model on the 3D-Alpaca dataset. Our work provides an effective attempt at extending multimodal models with basic 3D capabilities, which contributes to future research in 3D-native AI.