Update README.md

README.md

@@ -1,13 +1,50 @@
 ---
-title: VideoBackgroundReplacer2
-emoji: 🏢
-colorFrom: red
-colorTo: yellow
+title: 🎬 BackgroundFX Pro - SAM2 + MatAnyOne
+emoji: 🎥
+colorFrom: indigo
+colorTo: purple
 sdk: gradio
 sdk_version: 5.42.0
+python_version: 3.10
 app_file: app.py
 pinned: false
 license: mit
+tags:
+  - video
+  - background-removal
+  - segmentation
+  - matting
+  - SAM2
+  - MatAnyOne
+  - gradio
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎬 BackgroundFX Pro — SAM2 + MatAnyOne Edition
+
+**State-of-the-art video background replacement** with a simple Gradio UI.
+
+- ✅ **Segment Anything Model 2 (SAM2)** video propagation  
+- ✅ **MatAnyOne (CVPR 2025)** professional matting refinement  
+- ✅ GPU acceleration when available  
+- ✅ Robust fallbacks (SAM2-only → GrabCut)  
+- ✅ Backgrounds: gradient / solid / custom / AI (HF Inference API)
+
+## 🚀 How to use
+1. Upload a **video** (left panel)  
+2. Choose your **background** (gradient / solid / custom / AI)  
+3. Click **Process Video**  
+4. Download the **final video** in the Results panel 🎉
+
+## 📦 Files
+- `app.py` — main app (SAM2 + MatAnyOne + UI)  
+- `requirements.txt` — Python dependencies (commit-pinned for stability)  
+- `apt.txt` — system packages (`ffmpeg`, `git`, `cmake`, `build-essential`)  
+
+## 🛡️ Licenses
+Wrapper code: MIT.  
+Models: see their repos:  
+- [SAM2](https://github.com/facebookresearch/segment-anything-2)  
+- [MatAnyOne](https://github.com/pq-yang/MatAnyOne)
+
+👤 Maintainer: Mogens Rye  
+📧 Contact: mogens@ryeoutsourcing.dk