Add face swap notebook and README

README.md

@@ -1,14 +1,93 @@
 ---
 title: Video Face Replace
-emoji: 🏃
-colorFrom: green
-colorTo: red
+emoji: 🎭
+colorFrom: purple
+colorTo: pink
 sdk: gradio
 sdk_version: 6.10.0
 app_file: app.py
-pinned: false
+pinned: true
 license: mit
-short_description: Swap any face into any video using InsightFace + GFPGAN. Run
+short_description: Swap any face into any video using InsightFace + GFPGAN
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎭 Face Fusion — AI Video Face Swap
+
+Swap any face into any video using state-of-the-art AI. Built on **InsightFace**, **inswapper_128**, and **GFPGAN**.
+
+> ⚡ This is a **Kaggle notebook project** — run it there for full GPU-accelerated face swapping.
+> The Gradio UI is embedded inside the notebook (Cell 4).
+
+---
+
+## ✨ What It Does
+
+Upload a single clear photo of a face, point it at a YouTube video (or upload your own), and the pipeline replaces **every detected face** in the video with your source face — enhanced, sharpened, and re-merged with the original audio.
+
+**Pipeline:**
+
+```
+Source Face Photo → InsightFace Embedding
+       ↓
+Target Video (YouTube URL or upload)
+       ↓
+Per-frame: Face Detection → Swap (inswapper_128) → GFPGAN Enhancement
+       ↓
+Audio Merge (ffmpeg) → Final MP4
+```
+
+---
+
+## 🚀 How to Run (Kaggle)
+
+1. Open `Face_replace.ipynb` on [Kaggle](https://www.kaggle.com) with **GPU accelerator** (T4 or P100)
+2. **Cell 1** — installs packages + downloads models (~1 min)
+3. **Cell 2** — set source face path + YouTube URL, downloads & trims video
+4. **Cell 3** — processes all frames → outputs `face_swapped_output.mp4`
+5. **Cell 4** — launches interactive Gradio UI
+
+> Processes ~12 frames/second on T4 GPU
+
+---
+
+## 🧰 Tech Stack
+
+| Component | Role |
+|---|---|
+| InsightFace `buffalo_l` | Face detection + recognition |
+| `inswapper_128.onnx` | Neural face-swap model |
+| GFPGAN v1.4 | Face restoration & enhancement |
+| OpenCV | Frame-level video I/O |
+| ffmpeg | Video codec + audio merge |
+| yt-dlp | YouTube video download |
+| Gradio | Interactive UI |
+| ONNX Runtime GPU | GPU-accelerated inference |
+
+---
+
+## 💡 Tips for Best Results
+
+- Use a **clear, front-facing photo** — no sunglasses or heavy shadows
+- Keep target videos **under 30 seconds** for fast iteration
+- Single-face videos give the cleanest results
+- Enable GFPGAN (`ENABLE_ENHANCEMENT = True`) for sharper output
+
+---
+
+## ⚠️ Disclaimer
+
+For **creative, educational, and research purposes only**.
+Do not use to create deceptive, harmful, or non-consensual content.
+Always obtain permission before using someone's likeness.
+
+---
+
+## 🙏 Credits
+
+- [deepinsight/insightface](https://github.com/deepinsight/insightface)
+- [TencentARC/GFPGAN](https://github.com/TencentARC/GFPGAN)
+- [ezioruan/inswapper_128.onnx](https://huggingface.co/ezioruan/inswapper_128.onnx)
+
+---
+
+*Made with ❤️ by [Aastha Malik](https://github.com/aastha-malik)*