Update README.md

README.md

@@ -1,84 +1,60 @@
-# Matrix-Game-2.0 Hugging Face Space Setup
-
-## 🚀 Quick Setup Guide
-
-### 1. **Create the Space**
-- Go to [Hugging Face Spaces](https://huggingface.co/spaces)
-- Click "Create new Space"
-- Choose **Gradio** as the SDK
-- **IMPORTANT**: Set Hardware to **GPU (A100)** - this is crucial!
-
-### 2. **Upload Files**
-Upload these three files to your Space:
-
-1. **app.py** - The main application (use the clean version provided)
-2. **requirements.txt** - Dependencies list (properly formatted)
-3. **README.md** - This file (optional)
-
-### 3. **Space Configuration**
-In your Space settings, ensure:
-- **SDK**: Gradio
-- **Hardware**: A100 GPU (required!)
-- **Visibility**: Public or Private (your choice)
-
-### 4. **Key Improvements Made**
-
-#### ✅ **Fixed Issues:**
-- Proper requirements.txt formatting (each dependency on new line)
-- Added missing dependencies (opencv, xformers, etc.)
-- Used `@spaces.GPU` decorator for proper GPU allocation
-- Simplified model downloading and setup
-- Added proper error handling and timeouts
-- Reduced frame limits for HF Spaces constraints
-
-#### ✅ **HF Spaces Optimizations:**
-- Pre-download model weights efficiently
-- Use temporary directories properly
-- Clean up resources after generation
-- Progress indicators for user feedback
-- GPU memory management
+---
+title: Matrix-Game-2.0
+emoji: 🎮
+colorFrom: purple
+colorTo: blue
+sdk: gradio
+sdk_version: 4.42.0
+app_file: app.py
+suggested_hardware: a100-large
+suggested_storage: large
+python_version: 3.10
+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
+---
 
-### 5. **Usage Tips**
-- **First run**: Will take 2-3 minutes to download model (~10GB)
-- **Subsequent runs**: Much faster (model cached)
-- **Recommended**: 25-75 frames for reasonable generation time
-- **Input images**: Works best with landscapes/scenes, max 512px
+# 🎮 Matrix-Game-2.0
 
-### 6. **Troubleshooting**
+An interactive world foundation model for real-time video generation. Upload an image and generate dynamic video content with controllable parameters!
 
-#### If you get "CUDA out of memory":
-- Reduce number of frames (try 25-50)
-- Use smaller input images
-- Restart the Space
+## 🚀 How to Use
 
-#### If model download fails:
-- Check internet connection in Space logs
-- Verify you're using A100 GPU hardware
-- Try restarting the Space
+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
 
-#### If generation is slow:
-- This is normal! Video generation is compute-intensive
-- A100 GPU should handle 50 frames in ~2-3 minutes
-- Consider reducing frames for faster results
+## 💡 Tips
 
-### 7. **Expected Performance**
-- **Model download**: 2-3 minutes (first time only)
-- **25 frames**: ~1 minute generation
-- **50 frames**: ~2-3 minutes generation  
-- **75+ frames**: 4-5+ minutes generation
+- **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
 
-## 🎮 What is Matrix-Game-2.0?
+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
 
-Matrix-Game-2.0 is an interactive world foundation model that generates real-time video content based on input images. It uses advanced diffusion techniques to create dynamic, controllable video sequences that respond to user interactions.
+## 🔧 Model Information
 
-**Key Features:**
-- Real-time video generation (up to 25 FPS)
-- Interactive control through keyboard/mouse inputs
-- Long video generation capability
-- Fine-grained scene control and evolution
+- **Base Model**: Skywork/Matrix-Game-2.0
+- **Architecture**: Auto-regressive diffusion
+- **Input**: Single image + parameters
+- **Output**: MP4 video (configurable length)
 
 ---
 
-*Built with ❤️ for the Hugging Face community*
+*Powered by Hugging Face Spaces 🤗*