Tencent-Hunyuan/HunyuanWorld-1.0

Tencent-Hunyuan/HunyuanWorld-1.0

Description: Generating Immersive, Explorable, and Interactive 3D Worlds from Words or Pixels with Hunyuan3D World Model

Language: Python

License: NOASSERTION

Stars: 2843

Forks: 257

Open issues: 31

Created: 2025-07-18T19:58:43Z

Pushed: 2026-04-15T17:27:25Z

Default branch: main

Fork: no

Archived: no

README: [中文阅读](README_zh_cn.md)

[//]: # ( )

[//]: # ( )

[//]: # ( )

"To see a World in a Grain of Sand, and a Heaven in a Wild Flower"

https://github.com/user-attachments/assets/747b3e41-df9c-4cd2-b1d1-c0dce63f63ef

🔥 News

• April 16, 2026: 🤗 We release HY-World-2.0, state-of-the-art 3D world model!
• December 18, 2025: 🤗 We release HunyuanWorld-1.5 (WorldPlay), enabling real-time world creation and play!
• October 22, 2025: 🤗 We release HunyuanWorld-1.1 (WorldMirror), supporting 3D world creation from videos or multi-view images!
• October 16, 2025: 🤗 We recently propose FlashWorld, enabling 3DGS world generation in 5~10 seconds on a single GPU!
• September 2, 2025: 🤗 We release our RGB-D Video Diffusion model HunyuanWorld-Voyager, which supports 3D-consistency world exploration and fast 3D reconstruction!
• August 15, 2025: 🤗 We release the quantization version of HunyuanWorld-1.0 (HunyuanWorld-1.0-lite), which now supports running on Consumer-grade GPUs such as 4090!
• July 26, 2025: 👋 We present the technical report of HunyuanWorld-1.0, please check out the details and spark some discussion!
• July 26, 2025: 🤗 We release the first open-source, simulation-capable, immersive 3D world generation model, HunyuanWorld-1.0!

> Join our [Wechat](#) and [Discord](https://discord.gg/dNBrdrGGMa) group to discuss and find help from us.

| Wechat Group | Xiaohongshu | X | Discord | |--------------------------------------------------|-------------------------------------------------------|---------------------------------------------|---------------------------------------------------| | | | | |

☯️ HunyuanWorld 1.0

Abstract

Creating immersive and playable 3D worlds from texts or images remains a fundamental challenge in computer vision and graphics. Existing world generation approaches typically fall into two categories: video-based methods that offer rich diversity but lack 3D consistency and rendering efficiency, and 3D-based methods that provide geometric consistency but struggle with limited training data and memory-inefficient representations. To address these limitations, we present HunyuanWorld 1.0, a novel framework that combines the best of both sides for generating immersive, explorable, and interactive 3D worlds from text and image conditions. Our approach features three key advantages: 1) 360° immersive experiences via panoramic world proxies; 2) mesh export capabilities for seamless compatibility with existing computer graphics pipelines; 3) disentangled object representations for augmented interactivity. The core of our framework is a semantically layered 3D mesh representation that leverages panoramic images as 360° world proxies for semantic-aware world decomposition and reconstruction, enabling the generation of diverse 3D worlds. Extensive experiments demonstrate that our method achieves state-of-the-art performance in generating coherent, explorable, and interactive 3D worlds while enabling versatile applications in virtual reality, physical simulation, game development, and interactive content creation.

Architecture

Tencent HunyuanWorld-1.0's generation architecture integrates panoramic proxy generation, semantic layering, and hierarchical 3D reconstruction to achieve high-quality scene-scale 360° 3D world generation, supporting both text and image inputs.

Performance

We have evaluated HunyuanWorld 1.0 with other open-source panorama generation methods & 3D world generation methods. The numerical results indicate that HunyuanWorld 1.0 surpasses baselines in visual quality and geometric consistency.

Text-to-panorama generation:

| Method | BRISQUE(⬇) | NIQE(⬇) | Q-Align(⬆) | CLIP-T(⬆) | | ---------------- | --------------------- | ------------------ | ------------------- | ------------------ | | Diffusion360 | 69.5 | 7.5 | 1.8 | 20.9 | | MVDiffusion | 47.9 | 7.1 | 2.4 | 21.5 | | PanFusion | 56.6 | 7.6 | 2.2 | 21.0 | | LayerPano3D | 49.6 | 6.5 | 3.7 | 21.5 | | HunyuanWorld 1.0 | 40.8 | 5.8 | 4.4 | 24.3 |

Image-to-panorama generation:

| Method | BRISQUE(⬇) | NIQE(⬇) | Q-Align(⬆) | CLIP-I(⬆) | | ---------------- | --------------------- | ------------------ | ------------------- | ------------------ | | Diffusion360 | 71.4 | 7.8 | 1.9 | 73.9 | | MVDiffusion | 47.7 | 7.0 | 2.7 | 80.8 | | HunyuanWorld 1.0 | 45.2 | 5.8 | 4.3 | 85.1 |

Text-to-world generation:

| Method | BRISQUE(⬇) | NIQE(⬇) | Q-Align(⬆) | CLIP-T(⬆) | | ---------------- | --------------------- | ------------------ | ------------------- | ------------------ | | Director3D | 49.8 | 7.5 | 3.2 | 23.5 | | LayerPano3D | 35.3 | 4.8 | 3.9 | 22.0 | | HunyuanWorld 1.0 | 34.6 | 4.3 | 4.2 | 24.0 |

Image-to-world generation:

| Method | BRISQUE(⬇) | NIQE(⬇) | Q-Align(⬆) | CLIP-I(⬆) | | ---------------- | --------------------- | ------------------ | ------------------- | ------------------ | | WonderJourney | 51.8 | 7.3 | 3.2 | 81.5 | | DimensionX | 45.2 | 6.3 | 3.5 | 83.3 | | HunyuanWorld 1.0 | 36.2 | 4.6 | 3.9 | 84.5 |

Visual Results

360 ° immersive and explorable 3D worlds generated by HunyuanWorld 1.0:

🎁 Models Zoo

The open-source version of HY World 1.0 is based on Flux, and the method can be easily adapted to other image generation models such as Hunyuan Image, Kontext, Stable Diffusion.

| Model | Description | Date | Size | Huggingface | |--------------------------------|-----------------------------|------------|-------|----------------------------------------------------------------------------------------------------| | HunyuanWorld-PanoDiT-Text | Text to Panorama Model | 2025-07-26 | 478MB | Download | | HunyuanWorld-PanoDiT-Image | Image to Panorama Model |…