I. Summary
Hunyuan3D-Part is an open-source, component-level 3D shape generation and decomposition solution from Tencent Hunyuan. It consists of P3-SAM (native 3D part segmentation) and X-Part (controllable part generation). Its training does not rely on 2D SAM. Based on approximately 3.7 million shapes and clean part annotations, it provides automated 3D segmentation and diffuse part generation. The paper reports achieving state-of-the-art results on multiple benchmarks. The full functionality is available in Hunyuan3D Studio, and lightweight versions of P3-SAM and X-Part are available in the repository.
2. Core Features
1. Native 3D Segmentation : P3-SAM performs part detection and instance segmentation directly in 3D, supporting point hinting and fully automatic processes.
2. Controllable component generation : X-Part uses bounding boxes as constraints, integrates semantic and geometric features, and diffusely generates structurally consistent components.
3. Pure 3D data training : Removes reliance on 2D SAM and relies on large-scale 3D/component annotation data to improve robustness.
4. End-to-end pipeline : split first and then generate, editable, replaceable and reusable.
5. Parallel light and heavy versions : Open source lightweight version; full capabilities can be experienced in Studio.
3. Installation
1. Clone the repository: git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-Part.
2. Environment preparation: Install dependencies and PyTorch/CUDA according to the requirements of the subdirectories P3-SAM/ and XPart/.
- Download weights: Get the corresponding checkpoints from the Hugging Face model page and put them in the specified paths of each submodule.
- Quick Experience: Run the P3-SAM segmentation script to obtain parts and bounding boxes, then call X-Part to generate completed parts; or directly use Hugging Face Space for a lightweight demonstration.
Typical Use Cases
1. Asset reuse and editing : Automatically segment scanned or generated meshes and replace individual components.
2. Production-level modeling assistance : maintain structural consistency and facilitate topology reconstruction and UV unfolding.
3. Design iteration : Rapidly explore component shape and assembly using bounding box constraints.
4. Printing and manufacturing : Output independent parts to adapt to materials and processes.
5. Ecosystem and Competitive Products
- Ecosystem: Connect Hunyuan3D series and Studio; provide Hugging Face models and demonstrations.
Competitors: SAMPart3D, PartField, and PartGen rely heavily on 2D/3D distillation or multi-view solutions. Hunyuan3D-Part differentiates itself through its integrated pipeline of native 3D segmentation and controlled diffusion generation . The specific advantages and disadvantages of Hunyuan3D-Part will be determined based on public benchmarks and scenario verification.
VI. Limitations and Precautions
- The open source version is the X-Part lightweight version, and the full functionality is in Studio; the interface and indicators may evolve with each version.
- Long-tailed shapes and noise grids still need to be manually reviewed.
- Training/inference requires video memory, and a modern GPU is recommended. Mesh quality affects segmentation and generation stability.
- Please follow the respective license and terms of third-party datasets.
7. Project Address
https://github.com/Tencent-Hunyuan/Hunyuan3D-Part
8. Frequently Asked Questions
Q: Does Hunyuan3D-Part depend on 2D SAM?
A: No. P3-SAM is a native 3D segmentation model, and both training and inference are performed in 3D space.
Q: What is the scale and source of the data?
A: The paper states that approximately 3.7 million shapes and clean parts were used for annotation (the specific composition is subject to the paper and model card).
Q: Any suggestions for input grids?
A: P3-SAM is robust to input, but X-Part is more suitable for scanning or high-quality mesh generation.
Q: What is the difference between the Lite version and Studio?
A: The lightweight version is convenient for local reproduction and research; Studio provides more complete and stable production-level functions and computing power support.
Q: Is there an online experience?
A: You can use Hugging Face for a lightweight demo. If you need full functionality, go to Hunyuan3D Studio.
