What is hallo3d?

Hallo3D is the official code release for a research paper accepted at NeurIPS 2024, a major AI research conference. The project tackles a specific problem in AI generated 3D content: when a model builds a 3D object from a text description or an image, it can end up giving the object different, contradictory appearances depending on which angle you look at it from, sometimes called the Janus problem, where a single object appears to have multiple faces or inconsistent features across views. Hallo3D works as a plug in that attaches to existing 3D generation systems rather than replacing them, and it does not require retraining those systems or changing their architecture. It works through three connected steps. First, it aligns the color and texture of the object across different rendered viewpoints using an attention mechanism. Second, it uses a large multi-modal model, specifically LLaVA, to inspect the generated views and detect hallucinated or inconsistent details, turning what it finds into an enhanced negative prompt. Third, it uses that negative prompt to selectively correct the generation, nudging future views back toward consistency without needing to redo the whole process. The method is designed to work across a range of existing 3D generation frameworks, covering both text-to-3D approaches, such as DreamFusion, GaussianDreamer, SJC, and Magic3D, and image-to-3D approaches, such as Zero-1-to-3 and DreamGaussian, all built on top of the threestudio framework. Setting this up is involved. It requires first installing threestudio itself, then linking this repository's extension into threestudio's custom folder, cloning a couple of additional extensions for the GaussianDreamer baseline, and installing a compatible version of the transformers library to run the detection component. The README states it was tested on Python 3.12 with PyTorch 2.6, CUDA 11.8, and a single 80 GB A100 GPU per training run, so this is meant for people with real GPU infrastructure rather than a personal laptop. The authors also note that a newer, related project called Hallo4D, extending this idea to include time as well as 3D space, has since been released.