logo

Video Face Swap (VFS)

Swap any face in a video with a few clicks!!

contributors last update forks stars open issues license

View Demo · Documentation · Report Bug · Request Feature


# :notebook_with_decorative_cover: Table of Contents - [:notebook\_with\_decorative\_cover: Table of Contents](#notebook_with_decorative_cover-table-of-contents) - [:star2: About the Project](#star2-about-the-project) - [:camera: Screenshots](#camera-screenshots) - [:space\_invader: Tech Stack](#space_invader-tech-stack) - [:toolbox: Getting Started](#toolbox-getting-started) - [:bangbang: Prerequisites](#bangbang-prerequisites) - [:running: Run Locally](#running-run-locally) - [:eyes: Usage](#eyes-usage) - [:wave: Contributing](#wave-contributing) - [:scroll: Code of Conduct](#scroll-code-of-conduct) - [:warning: License](#warning-license) - [:handshake: Contact](#handshake-contact) - [:gem: Acknowledgements](#gem-acknowledgements) ## :star2: About the Project It detects faces and then group them together so you can upload a new face for a group and it will be swapped in the whole video. ### :camera: Screenshots
![Alt text](assets/mark_chris_elon.gif) ### :space_invader: Tech Stack ## :toolbox: Getting Started ### :bangbang: Prerequisites ### :running: Run Locally Clone the project ```bash git clone https://github.com/karanjakhar/Video-Face-Swap.git ``` Go to the project directory ```bash cd Video-Face-Swap ``` Install dependencies ```bash cd Video-Face-Swap/frontend npm install cd Video-Face-Swap/backend pip install -r requirements.txt ``` Run Backend and Frontend ```bash cd Video-Face-Swap/frontend npm start cd Video-Face-Swap/backend python3 main.py ``` Model Weights ``` Download model weight files from release and place them in weights/ folder. ``` ## :eyes: Usage Project is in two part frontend (ReactJS) and backend (Python, FastAPI). To run it locally you need to run both. ## :wave: Contributing Contributions are always welcome! See `contributing.md` for ways to get started. ### :scroll: Code of Conduct Please read the [Code of Conduct](https://github.com/karanjakhar/Video-Face-Swap/blob/master/CODE_OF_CONDUCT.md) ## :warning: License Distributed under Apache2.0. See LICENSE for more information. ## :handshake: Contact Karan Jakhar - [@karan-jakhar](https://www.linkedin.com/in/karan-jakhar/) - karanjakhar49@gmail.com Project Link: [https://github.com/karanjakhar/Video-Face-Swap](https://github.com/karanjakhar/Video-Face-Swap) ## :gem: Acknowledgements - [InsightFace](https://github.com/deepinsight/insightface) - [FaceFusion](https://github.com/facefusion/facefusion) - [Readme Template](https://github.com/Louis3797/awesome-readme-template)