README.md

---
title: Matrix-Game-2.0
emoji: 🎮
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.43.1
app_file: app.py
suggested_hardware: a100-large
suggested_storage: large
python_version: 3.1
short_description: Interactive World Model for Real-Time Video Generation
tags:
- video-generation
- diffusion
- interactive
- world-model
- matrix-game
models:
- Skywork/Matrix-Game-2.0
pinned: false
license: mit
---

# 🎮 Matrix-Game-2.0

An interactive world foundation model for real-time video generation. Upload an image and generate dynamic video content with controllable parameters!

## 🚀 How to Use

1. **Upload an Image**: Choose a landscape or scene image (works best)
2. **Set Parameters**: 
   - **Frames**: 25-100 (lower = faster generation)
   - **Seed**: Any number for reproducibility
3. **Generate**: Click the button and wait 2-5 minutes

## 💡 Tips

- **First run** takes longer (downloads model weights ~10GB)
- **Best inputs**: Clear, well-lit outdoor scenes or landscapes
- **Frame recommendations**: 25-50 frames for faster results
- **Hardware**: Requires GPU acceleration (A100 recommended)

## ⚙️ Technical Details

Built on the Matrix-Game-2.0 model by SkyworkAI, this Space provides:
- Real-time video generation up to 25 FPS
- Interactive control through diffusion-based synthesis
- Long video generation capabilities
- Fine-grained scene evolution

## 🔧 Model Information

- **Base Model**: Skywork/Matrix-Game-2.0
- **Architecture**: Auto-regressive diffusion
- **Input**: Single image + parameters
- **Output**: MP4 video (configurable length)

---

*Powered by Hugging Face Spaces 🤗*