# HunyuanWorld 1.0

HunyuanWorld 1.0 generates a 360° explorable 3D world from text or an image: it builds a panorama, splits it into semantic layers and reconstructs them in 3D. A quantized Lite version targets consumer graphics cards.

Organization: Tencent Hunyuan. Released: 27 July 2025. Kind: 3D world builder.

## What you control

- A text prompt or an image
- Free exploration of the reconstructed 3D world

## License

Weights: Available (https://huggingface.co/tencent/HunyuanWorld-1). Declared license: Tencent HunyuanWorld-1.0 Community License.
Only under its own license (Tencent HunyuanWorld-1.0 Community License). Not licensed in the European Union, the United Kingdom or South Korea. Services above 1 million monthly active users need a separate license from Tencent.

## Real-time

No real-time claim.

## How to run it

1. Create the conda environment from docker/HunyuanWorld.yaml and install Real-ESRGAN, ZIM and the other listed dependencies.
2. Log in to Hugging Face so the weights can download.
3. Generate a panorama from an image or a prompt, then turn it into a 3D world scene; you can name foreground objects to separate into layers.

## Where to try

- [Official](https://3d.hunyuan.tencent.com/sceneTo3D)

## Sources

- [Project source](https://github.com/Tencent-Hunyuan/HunyuanWorld-1.0)
- [Weights and model card](https://huggingface.co/tencent/HunyuanWorld-1)

## Questions

### Is HunyuanWorld 1.0 open source?

HunyuanWorld 1.0 publishes downloadable weights under Tencent HunyuanWorld-1.0 Community License. Read the license terms before you build on it.

### Can I use HunyuanWorld 1.0 commercially?

Only under its own license (Tencent HunyuanWorld-1.0 Community License). Not licensed in the European Union, the United Kingdom or South Korea. Services above 1 million monthly active users need a separate license from Tencent.

### Does HunyuanWorld 1.0 run in real time?

The cited sources do not claim real-time operation.

### Where can I try HunyuanWorld 1.0?

You can try it on the official site.

### What does HunyuanWorld 1.0 take as input?

You give it a text prompt or an image and free exploration of the reconstructed 3D world.

### How do I run HunyuanWorld 1.0?

Following the official instructions: Create the conda environment from docker/HunyuanWorld.yaml and install Real-ESRGAN, ZIM and the other listed dependencies. Log in to Hugging Face so the weights can download. Generate a panorama from an image or a prompt, then turn it into a 3D world scene; you can name foreground objects to separate into layers.

### What are alternatives to HunyuanWorld 1.0?

Similar models in this directory include HY-World 2.0 (open weights, custom terms), Marble (no public weights, service terms) and Matrix-3D (open weights, permissive license).

Checked 2026-10-23. Corrections: https://github.com/windflow-labs/world-model-directory
