~/runthismodel
daemon okbuild 5a3c91d00:00:00Z
./models/browse/hunyuan3d-2
Tencent · 3d-gen
Hunyuan3D 2
Two-stage image-to-3D — shape generation then PBR texture synthesis. Strong topology.
2.5b paramshunyuan3dtencent-hunyuan1616 GB vram
about·model card

Hunyuan3D 2 splits 3D generation into shape + texture stages. The PBR texture pass is what sets it apart — the meshes ship with realistic materials, not just colors baked into vertices.

probe://hardware·which quants fit your rig
we auto-detect via WebGL/WebGPU. select manually if your GPU isn't recognized.
./quantizations·1 variants
QuantizationBitsFile SizeVRAM NeededRAM NeededQuality
FP16165 GB16 GB24 GB
100%

How to run Hunyuan3D 2

Pick a runtime — copy & paste. Commands are pre-filled with this model’s repo.

GUI. Browse → download → chat. MLX on Apple Silicon.

LM Studio home →
  1. 1

    Open LM Studio

    Go to the 🔍 Search tab.

  2. 2

    Search for

    tencent/Hunyuan3D-2
  3. 3

    Download

    Pick the FP16 quant — best balance of size vs. quality.

  4. 4

    Chat

    Hit ▶ Load Model and start chatting. Toggle 'Local Server' to expose an OpenAI-compatible API on :1234.

Community benchmarks

Real tokens/sec reports from people running Hunyuan3D 2 on actual hardware.

No community runs yet for this model. Be the first to submit your numbers.

faq·common questions
how much VRAM do I need to run Hunyuan3D 2?

Hunyuan3D 2 requires 16 GB VRAM minimum with FP16 quantization. For full precision you need 16 GB.

which quant should I pick?

Q4_K_M is the best quality/VRAM balance — ~92% of FP16 quality at ~25% the footprint. Q8_0 is near-lossless if you have the headroom.

faq://ai-curated·20 entries
What GPU do I need to run Hunyuan3D 2?

To run Hunyuan3D 2, you need a GPU with at least 16 GB of VRAM. Higher-end GPUs like the RTX 3090 or A6000 are recommended for optimal performance.

Is Hunyuan3D 2 good for coding?

Hunyuan3D 2 is primarily designed for generating 3D models from images and is not optimized for coding tasks. For coding, consider language models like Codex or AlphaCode.

Hunyuan3D 2 vs Llama 3.1 8B?

Hunyuan3D 2 is specialized for 3D generation with 2.5B parameters, while Llama 3.1 8B is a larger, more general-purpose language model. Choose based on your specific task needs.

Can I run Hunyuan3D 2 on a Mac?

Yes, you can run Hunyuan3D 2 on a Mac with a compatible GPU that has at least 16 GB of VRAM. Ensure you have the necessary drivers and CUDA support installed.

How much VRAM does Hunyuan3D 2 need?

Hunyuan3D 2 requires 16 GB of VRAM. The exact amount can vary slightly depending on the quantization level used.

Is Hunyuan3D 2 censored?

Hunyuan3D 2 is not explicitly censored, but it adheres to standard content guidelines to ensure appropriate and safe use.

Is Hunyuan3D 2 commercial-use allowed?

Hunyuan3D 2 is licensed under the tencent-hunyuan license, which allows for commercial use. Check the license terms for any specific restrictions.

Hunyuan3D 2 context length?

The context length for Hunyuan3D 2 is currently unknown. It is designed for 3D generation tasks rather than text-based models, so context length may not be applicable in the same way.

Does Hunyuan3D 2 support function calling?

Hunyuan3D 2 is designed for 3D generation and does not support function calling in the way that language models do. It focuses on image-to-3D conversion.

Hunyuan3D 2 quantization options?

Hunyuan3D 2 supports various quantization options to reduce VRAM usage, including INT8 and FP16. Check the documentation for the best settings for your hardware.

Can Hunyuan3D 2 run on CPU?

While Hunyuan3D 2 can technically run on a CPU, it is highly inefficient and not recommended. Use a GPU with at least 16 GB of VRAM for optimal performance.

Hunyuan3D 2 fine-tuning?

Hunyuan3D 2 can be fine-tuned for specific 3D generation tasks. However, this requires significant computational resources and expertise in training 3D models.

Hunyuan3D 2 system requirements?

Hunyuan3D 2 requires a GPU with at least 16 GB of VRAM, a modern CPU, and at least 16 GB of RAM. Ensure you have a stable internet connection for downloading the model.

Hunyuan3D 2 performance benchmark?

Performance benchmarks for Hunyuan3D 2 show it can generate high-quality 3D models in a few minutes on a high-end GPU like the RTX 3090. Exact times can vary based on input complexity.

Hunyuan3D 2 for RAG?

Hunyuan3D 2 is not designed for Retrieval-Augmented Generation (RAG). It is specialized for 3D generation tasks and does not integrate with retrieval systems.

Hunyuan3D 2 for agents?

Hunyuan3D 2 can be used to generate 3D assets for virtual agents or avatars, but it does not have built-in capabilities for creating or controlling agents.

Hunyuan3D 2 for coding vs general?

Hunyuan3D 2 is not suitable for coding tasks. It is specialized for 3D generation and is not a general-purpose model like those used for coding or text generation.

Hunyuan3D 2 vs ChatGPT?

Hunyuan3D 2 is a 3D generation model, while ChatGPT is a large language model designed for conversational and text generation tasks. They serve different purposes and are not directly comparable.

Hunyuan3D 2 download size?

The download size for Hunyuan3D 2 is approximately 10 GB, depending on the quantization level and additional dependencies.

Best quant for Hunyuan3D 2?

The best quantization for Hunyuan3D 2 depends on your hardware. FP16 provides a good balance between performance and VRAM usage, while INT8 can further reduce VRAM requirements with a slight performance trade-off.