Spaces:
Running
Running
| title: Video Face Replace | |
| emoji: 🎭 | |
| colorFrom: purple | |
| colorTo: pink | |
| sdk: gradio | |
| sdk_version: 6.10.0 | |
| app_file: app.py | |
| pinned: true | |
| license: mit | |
| short_description: Swap any face into any video using InsightFace + GFPGAN | |
| # 🎭 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)* | |