---
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)*