Face Swap

Face Swap

A Gradio face swapping demo from felixrosberg that runs on the FaceDancer family of models. Open it in a browser or run a copy yourself to try face swapping for research or learning.

Made by felixrosberg on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: Face Swap is a Gradio demo by felixrosberg for swapping faces in pictures. The Space names six models from the same author, including FaceDancer, ArcFace and RetinaFace. The card is only Hugging Face's standard settings list, so the page itself is the best way to see what the controls do.

Who it suits: Researchers and students who want to try a published face swapping model without setting anything up. Developers can also read the code to see how the models are wired together.

Industry | Who uses it | How they use it | Example
Research | Computer vision researchers | Try the models on pictures they have the right to use | Open the Space and follow its on-page controls
Education | Students | See a face swapping pipeline working in a browser | Run the demo, then read app.py
Software | Developers | Study how several models are combined in one app | Look through the networks and utils folders in a local copy

If you need a tool for commercial work, you can skip it, because the license is non-commercial.

Where to use it: The demo runs in these places:

• A web browser: open the Space page on Hugging Face and use it there.
• Windows, macOS or Linux: run a copy on your own computer with Python.

Use case | Who | What they get back
Try face swapping online | Curious visitors and students | An edited picture from the Gradio page
Study the code | Developers | The app file plus networks, options and utils folders
Run it locally | Researchers | The same Gradio demo on their own computer

How to set it up: You need a few things first:

• Python
• The huggingface_hub package, which the first command installs
• The packages listed in requirements.txt

The steps download the Space, install Gradio at the version the Space uses, add the other packages and start the app.

1. Install the Hugging Face package.
2. Download the Space into a folder called face-swap.
3. Move into that folder.
4. Install Gradio 4.29.0.
5. Install the packages from requirements.txt.
6. Start the app.

pip install -U huggingface_hub
hf download felixrosberg/face-swap --repo-type space --local-dir face-swap
cd face-swap
pip install gradio==4.29.0
pip install -r requirements.txt
python app.py

How to use it: Open the Space page on Hugging Face, or start the local copy with the last command above. Gradio serves a web page with the controls for the swap. Use pictures of people who agreed to it.

python app.py

Tool | What it does
hf download | Copies the Space's files into a folder on your computer
python app.py | Starts the demo on your own computer

Example: You open the Space, follow its on-page controls with pictures you have the right to use, and expect an edited image back. The card does not list the exact inputs, so the page is the guide.

For newcomers and experts: If you are new to this, open the Space page and try it once with a picture you own. You do not need to install anything for that. A local copy is only worth the setup when you want to read the code.

If you know the field, the Space names felixrosberg models for FaceDancer, ArcFace, RetinaFace, an identity permuter, a reconstruction attack and an AFFA configuration. The repository keeps the code in networks, options and utils folders next to app.py.

You open the Space or run python app.py
A Gradio page takes your pictures
The named face models work on them
The edited image shows on the page

Good to know: The card does not describe inputs, output size or limits.

• License: cc-by-nc-sa-4, a non-commercial share-alike license.
• Cost to run: none named. The hosted Space runs on the cpu-basic hardware at Hugging Face.
• Data it reaches: the pictures you give it. A local copy also downloads the Space's files from Hugging Face.
• Not for: commercial use, since the license is non-commercial.

On Hugging Face, 13 November 2026

• Likes: 808
• Built with: gradio
• License: cc-by-nc-sa-4.0

Links

• Space: https://huggingface.co/spaces/felixrosberg/face-swap
• Files: https://huggingface.co/spaces/felixrosberg/face-swap/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.