# Hunyuan-GameCraft

Hunyuan-GameCraft generates game-like video from a reference image, a prompt and keyboard or mouse input, which it maps into a shared camera space so moves blend smoothly. A distilled variant is aimed at real-time use.

Organization: Tencent Hunyuan. Released: 14 August 2025. Kind: Games.

## What you control

- A reference image and prompt
- Keyboard movement (W, A, S, D)
- Mouse look

## License

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

## Real-time

Real-time, per authors. A distilled version is described as suitable for real-time deployment; no frame rate in the README.

## How to run it

1. Clone Hunyuan-GameCraft-1.0, create a Python 3.10 conda environment and install requirements.txt and FlashAttention 2, or use the HunyuanVideo Docker image.
2. Download the pretrained models listed in the README.
3. Run inference with the provided scripts, or launch the Gradio demo with scripts/launch_app_sp.sh.

## Where to try

No hosted destination verified.

## Sources

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

## Questions

### Is Hunyuan-GameCraft open source?

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

### Can I use Hunyuan-GameCraft commercially?

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

### Does Hunyuan-GameCraft run in real time?

Yes, according to its authors. A distilled version is described as suitable for real-time deployment; no frame rate in the README. This directory has not measured it independently.

### Where can I try Hunyuan-GameCraft?

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

### What does Hunyuan-GameCraft take as input?

You give it a reference image and prompt; keyboard movement (W, A, S, D); and mouse look.

### How do I run Hunyuan-GameCraft?

Following the official instructions: Clone Hunyuan-GameCraft-1.0, create a Python 3.10 conda environment and install requirements.txt and FlashAttention 2, or use the HunyuanVideo Docker image. Download the pretrained models listed in the README. Run inference with the provided scripts, or launch the Gradio demo with scripts/launch_app_sp.sh.

### What are alternatives to Hunyuan-GameCraft?

Similar models in this directory include Agora (Odyssey) (no public weights, service terms), Matrix-Game 2.0 (open weights, permissive license) and Matrix-Game 3.0 (open weights, permissive license).

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