← all repositories
Tencent-Hunyuan/Hunyuan3D-Omni

Hunyuan3D-Omni adds a steering wheel to 3D generation

It bolts a unified control encoder onto Hunyuan3D 2.1 so you can nudge image-to-3D generation with bounding boxes, skeletons, point clouds, or voxels instead of leaving it to chance.

598 stars Python Image · Video · Audio
Hunyuan3D-Omni
Not currently ranked — collecting fresh signals.
star history

What it does

Hunyuan3D-Omni is an image-to-3D model built atop Hunyuan3D 2.1. It generates 3D assets from a source image, but adds a unified control encoder that accepts extra spatial instructions—think skeletal poses, point clouds, voxel grids, or 3D bounding boxes—to constrain the output. Inference requires about 10 GB of VRAM.

The interesting bit

Most image-to-3D systems are “take it or leave it” propositions: you hand over a picture and hope for the best. Hunyuan3D-Omni bolts a single shared encoder onto the existing Hunyuan3D backbone, turning open-ended generation into something closer to a parametric modeling session where rough proxies and poses all speak the same language.

Key highlights

  • Inherits the full Hunyuan3D 2.1 architecture, so the base image-to-3D capability is already established.
  • Supports four distinct control modalities: bbox, pose, point, and voxel.
  • Ships as a single 3.3B-parameter checkpoint, so you do not need separate models for each control mode.
  • Offers an EMA inference mode for more stable outputs and a flashvdm path for faster generation.
  • Runs on a relatively modest 10 GB of VRAM.

Caveats

  • The usage examples imply only one --control_type can be selected per run; the README never clarifies whether multiple control signals can be combined simultaneously.
  • The model is explicitly labeled an “Image to Shape” checkpoint, leaving it unclear whether texture generation is included or if the output is geometry-only.
  • Documentation is minimal beyond basic inference flags; licensing and training data details are not discussed.

Verdict

Worth exploring if you need steerable 3D geometry and already work with rough proxies like point clouds or voxels. Skip it if you are looking for a polished, fully documented production tool with clear licensing and out-of-the-box multi-control blending.

Frequently asked

What is Tencent-Hunyuan/Hunyuan3D-Omni?
It bolts a unified control encoder onto Hunyuan3D 2.1 so you can nudge image-to-3D generation with bounding boxes, skeletons, point clouds, or voxels instead of leaving it to chance.
Is Hunyuan3D-Omni open source?
Yes — Tencent-Hunyuan/Hunyuan3D-Omni is an open-source project tracked on heatdrop.
What language is Hunyuan3D-Omni written in?
Tencent-Hunyuan/Hunyuan3D-Omni is primarily written in Python.
How popular is Hunyuan3D-Omni?
Tencent-Hunyuan/Hunyuan3D-Omni has 598 stars on GitHub.
Where can I find Hunyuan3D-Omni?
Tencent-Hunyuan/Hunyuan3D-Omni is on GitHub at https://github.com/Tencent-Hunyuan/Hunyuan3D-Omni.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.