Update README.md

README.md

@@ -1,6 +1,6 @@
 ---
-title: BackgroundFX Pro - SAM2 Powered
-emoji: 🎥
+title: BackgroundFX Pro - SAM2 + MatAnyone
+emoji: 🎬
 colorFrom: blue
 colorTo: purple
 sdk: gradio
@@ -12,85 +12,143 @@ suggested_hardware: t4-small
 suggested_storage: small
 ---
 
-# 🎥 BackgroundFX Pro - SAM2 Powered
+# 🎬 BackgroundFX Pro - SAM2 + MatAnyone
 
-**Professional AI video background replacement with advanced segmentation**
+**Professional AI video background replacement with state-of-the-art segmentation and alpha matting**
 
-Upload your video and let SAM2 AI automatically detect and replace the background with precision. Optimized for Hugging Face Spaces with smart memory management and lazy loading.
+Powered by **SAM2** (Meta's Segment Anything Model 2) and **MatAnyone** (CVPR 2025) for Hollywood-quality video background replacement with professional alpha matting.
 
-## ✨ Features
+## ✨ Key Features
 
-- **🤖 SAM2 Integration**: State-of-the-art segmentation with Meta's SAM2
-- **⚡ Smart Loading**: True lazy loading - models download only when needed  
+- **🤖 SAM2 Integration**: State-of-the-art object segmentation from Meta
+- **🎭 MatAnyone Professional Matting**: CVPR 2025 video matting with memory propagation
+- **⚡ Smart Pipeline**: SAM2 segmentation → MatAnyone refinement → Perfect compositing
 - **🎨 Background Options**: 8 built-in presets + custom image upload
-- **🔧 Advanced Settings**: Model size selection and edge smoothing
-- **💾 Memory Optimized**: Automatic cleanup and CUDA cache management
-- **📱 Professional UI**: Clean, intuitive interface with real-time progress
+- **💾 Memory Optimized**: Lazy loading with automatic cleanup
+- **📱 Professional UI**: Clean interface with real-time progress tracking
 
 ## 🚀 Quick Start
 
-1. Upload a video (MP4, AVI, MOV, MKV, WebM - max 5 minutes)
-2. Choose a background preset or upload custom image  
-3. Select AI model size (Tiny/Small/Base)
-4. Click "Replace Background" and wait for processing
-5. Download your professional video!
+1. **Upload Video**: Drag & drop your video (MP4, AVI, MOV, MKV, WebM - max 5 minutes)
+2. **Choose Background**: Select from presets or upload custom image
+3. **Select Quality**: Choose SAM2 model size and MatAnyone settings
+4. **Process**: Click "Create Professional Video" and wait for magic
+5. **Download**: Get your Hollywood-quality result!
 
-## 💡 Pro Tips
+## 🎯 Professional Pipeline
 
-- **Best results**: Clear subject separation from background
-- **Lighting**: Even lighting works best for accurate segmentation  
-- **Movement**: Minimal camera shake recommended
-- **Processing time**: ~30-60 seconds per minute of video
-- **GPU acceleration**: Automatically uses available GPU for faster processing
+### **Stage 1: SAM2 Segmentation**
+- Meta's Segment Anything Model 2 detects and segments the main subject
+- Multiple model sizes: Tiny (38MB), Small (185MB), Base (320MB)
+- Smart point selection for optimal segmentation
 
-## 🔧 Technical Details
+### **Stage 2: MatAnyone Alpha Matting**
+- CVPR 2025 state-of-the-art video matting
+- Memory-based propagation for stable boundaries
+- Professional hair and edge detail preservation
+- Target-assigned matting using SAM2 masks
 
-- **Models**: SAM2 Tiny (38MB), Small (185MB), Base (320MB)
-- **Formats**: Supports all major video formats
-- **Resolution**: Up to 1920x1080 (Full HD)  
+### **Stage 3: Professional Compositing**
+- Seamless background replacement
+- Advanced edge smoothing and blending
+- Cinema-quality output
+
+## 🔧 Technical Specifications
+
+### **AI Models**
+- **SAM2**: Meta's Segment Anything Model 2 for object detection
+- **MatAnyone**: CVPR 2025 video matting with consistent memory propagation
+- **Processing**: Lazy loading, CUDA optimization, memory management
+
+### **Supported Formats**
+- **Input**: MP4, AVI, MOV, MKV, WebM
+- **Resolution**: Up to 1920x1080 (Full HD)
 - **Duration**: Max 5 minutes on free tier
-- **Memory**: True lazy loading with automatic cleanup
+- **Output**: High-quality MP4 with professional alpha compositing
+
+## ⚡ Performance Guide
+
+| Hardware | SAM2 Only | SAM2 + MatAnyone | Recommended Use |
+|----------|-----------|------------------|-----------------|
+| CPU | 3-5 min/video min | 6-10 min/video min | Quick tests only |
+| T4-small | 45-90s/video min | 90-180s/video min | ⭐ **Recommended** |
+| T4-medium+ | 30-60s/video min | 60-120s/video min | **Professional** |
+
+## 🎨 Background Presets
+
+Choose from 8 professional presets:
+- **🌊 Ocean Blue** - Clean professional gradient
+- **🌅 Sunset Orange** - Warm and vibrant atmosphere
+- **🌲 Forest Green** - Natural and calming backdrop
+- **💜 Purple Haze** - Creative and modern aesthetic
+- **⚪ Pure White** - Minimal and clean
+- **⚫ Pure Black** - Dramatic high-contrast
+- **💚 Chroma Green** - For further video editing
+- **💙 Chroma Blue** - Alternative chroma key
 
-## 🎬 Use Cases
+## 🎬 Professional Use Cases
 
-- **Content Creation**: Remove messy backgrounds for professional videos
-- **Virtual Meetings**: Create custom backgrounds for video calls
-- **Education**: Clean backgrounds for instructional videos  
-- **Social Media**: Eye-catching backgrounds for posts and stories
+- **🎯 Content Creation**: Remove distracting backgrounds for professional videos
+- **📹 Virtual Production**: Custom backgrounds for video calls and streaming
+- **🎓 Education**: Clean, professional backgrounds for instructional content
+- **📱 Social Media**: Eye-catching backgrounds that increase engagement
+- **🎪 Entertainment**: Creative backgrounds for artistic and commercial projects
+
+## 🛠️ Advanced Settings
+
+### **SAM2 Model Selection**
+- **Tiny**: Fastest processing, good quality (recommended for quick previews)
+- **Small**: Balanced speed and quality (recommended for most use cases)
+- **Base**: Best quality, slower processing (recommended for final videos)
+
+### **MatAnyone Options**
+- **Professional Mode**: Full MatAnyone processing for cinema-quality results
+- **Fast Mode**: SAM2-only processing for quick turnaround
+
+### **Edge Enhancement**
+- **Edge Smoothing**: 0-5 scale for softer subject boundaries
+- **Memory Propagation**: Automatic temporal consistency across frames
 
 ## 🏗️ Built With
 
-- [SAM2](https://github.com/facebookresearch/segment-anything-2) - Meta's Segment Anything Model 2
-- [Gradio](https://gradio.app/) - Machine learning web interface framework
-- [OpenCV](https://opencv.org/) - Computer vision library
-- [PyTorch](https://pytorch.org/) - Deep learning framework
+- [**SAM2**](https://github.com/facebookresearch/segment-anything-2) - Meta's Segment Anything Model 2
+- [**MatAnyone**](https://github.com/pq-yang/MatAnyone) - CVPR 2025 Video Matting Framework
+- [**Gradio**](https://gradio.app/) - Machine learning web interface framework
+- [**OpenCV**](https://opencv.org/) - Computer vision and video processing
+- [**PyTorch**](https://pytorch.org/) - Deep learning framework
 
 ## 📋 System Requirements
 
 - **Recommended**: GPU-enabled Space (T4-small or better)
-- **Minimum**: CPU-only mode supported but slower  
+- **Minimum**: CPU-only mode supported but significantly slower
 - **Memory**: Automatic management with CUDA optimization
-- **Storage**: No persistent storage needed (lazy loading)
+- **Storage**: No persistent storage needed (true lazy loading)
 
-## 🎯 Background Presets
+## 🔬 Research Citations
 
-Choose from 8 beautiful presets:
-- **Ocean Blue** - Professional gradient
-- **Sunset Orange** - Warm and vibrant  
-- **Forest Green** - Natural and calm
-- **Purple Haze** - Creative and modern
-- **Pure White** - Clean and minimal
-- **Pure Black** - Dramatic effect
-- **Chroma Green** - For further editing
-- **Chroma Blue** - Alternative chroma key
+```bibtex
+@InProceedings{yang2025matanyone,
+    title = {{MatAnyone}: Stable Video Matting with Consistent Memory Propagation},
+    author = {Yang, Peiqing and Zhou, Shangchen and Zhao, Jixin and Tao, Qingyi and Loy, Chen Change},
+    booktitle = {CVPR},
+    year = {2025}
+}
 
-## ⚡ Performance Guide
+@article{ravi2024sam2,
+    title = {SAM 2: Segment Anything in Images and Videos},
+    author = {Ravi, Nikhila and Gabeur, Valentin and Hu, Yuan-Ting and Hu, Ronghang and Ryali, Chaitanya and Ma, Tengyu and Khedr, Haitham and Rädle, Roman and Rolland, Chloe and Gustafson, Laura and Mintun, Eric and Pan, Junting and Alwala, Kalyan Vasudev and Carion, Nicolas and Wu, Chao-Yuan and Girshick, Ross and Dollár, Piotr and Feichtenhofer, Christoph},
+    journal = {arXiv preprint arXiv:2408.00714},
+    year = {2024}
+}
+```
+
+## 🔗 Links
 
-| Hardware | Processing Speed | Best Model | Concurrent Users |
-|----------|------------------|------------|------------------|
-| CPU | 2-3 min/video min | Tiny | 1 |
-| T4-small | 30-60s/video min | Small | 1-2 |
-| T4-medium | 20-40s/video min | Base | 2-3 |
-| A10G+ | 15-30s/video min | Base | 3-5 |
+- **Project Website**: [BackgroundFX Pro Demo](https://huggingface.co/spaces/your-username/backgroundfx-pro)
+- **SAM2 Repository**: [facebookresearch/segment-anything-2](https://github.com/facebookresearch/segment-anything-2)
+- **MatAnyone Repository**: [pq-yang/MatAnyone](https://github.com/pq-yang/MatAnyone)
+- **Configuration Reference**: [HF Spaces Config](https://huggingface.co/docs/hub/spaces-config-reference)
+
+---
 
-Check out the [configuration reference](https://huggingface.co/docs/hub/spaces-config-reference) for more details.
+**Ready to create professional videos with AI?** Upload your video and experience the future of background replacement! 🚀