# HY-WorldPlay

HY-World 1.5 (WorldPlay) is Tencent's streaming world model: it turns keyboard and mouse input into camera movement in real time and keeps the scene geometrically consistent when you return to a place.

Organization: Tencent Hunyuan. Released: 17 December 2025. Kind: Explorable world.

## What you control

- Keyboard and mouse
- A camera trajectory
- A starting image or text prompt

## License

Weights: Available (https://huggingface.co/tencent/HY-WorldPlay). Declared license: Tencent HY-WorldPlay Community License.
Only under its own license (Tencent HY-WorldPlay 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

Real-time, per authors. Real-time latency with streaming generation.

## How to run it

1. Create a Python 3.10 conda environment and install requirements.txt and an attention library (SageAttention or flash-attn).
2. Run python download_models.py with your Hugging Face token to fetch every required model.
3. Set the model paths it prints and run the HunyuanVideo-based inference, steering the camera with a pose string or a trajectory.

## Where to try

No hosted destination verified.

## Sources

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

## Questions

### Is HY-WorldPlay open source?

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

### Can I use HY-WorldPlay commercially?

Only under its own license (Tencent HY-WorldPlay 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 HY-WorldPlay run in real time?

Yes, according to its authors. Real-time latency with streaming generation. This directory has not measured it independently.

### Where can I try HY-WorldPlay?

No hosted version was verified; run the published weights yourself.

### What does HY-WorldPlay take as input?

You give it keyboard and mouse, a camera trajectory and a starting image or text prompt.

### How do I run HY-WorldPlay?

Following the official instructions: Create a Python 3.10 conda environment and install requirements.txt and an attention library (SageAttention or flash-attn). Run python download_models.py with your Hugging Face token to fetch every required model. Set the model paths it prints and run the HunyuanVideo-based inference, steering the camera with a pose string or a trajectory.

### What are alternatives to HY-WorldPlay?

Similar models in this directory include ABot-World (open weights, permissive license), AlayaWorld (open weights, custom terms) and DreamX-World (open weights, permissive license).

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