Practical overview
When it fits
Use it when you want to examine or build on a documented Python workflow for fitting a 3D face model to camera landmarks and blending the result into live footage.
Who it is for
- People seeking a local camera-based 3D face-swapping application.
- Students and developers studying facial landmarks, 3D face fitting, blendshapes and image blending.
Documented uses
- Swap a camera-visible face with a face from a reference image.
- Study or prototype landmark-based 3D face fitting and blending for live camera effects.
Requirements & limits
The code is licensed under MIT. The README identifies some project data as third-party material.
- The application uses Python 3, installed dependencies and a separately downloaded 68-point landmark model.
- The documented version uses Gauss–Newton fitting, blendshapes, rendering and alpha blending.
- A separate Deep Alignment Network-based version is described as faster on GPU and as producing more stable and precise landmarks; it is not included in this repository's code.
- The README says some data comes from third parties, so asset rights may differ from the code licence.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the documented FaceSwap application
Prepare the documented Python dependencies and landmark model, then start the application.
Before you start
- Python 3
- The project repository and its requirements.txt file
- The 68-point face-landmark model file shape_predictor_68_face_landmarks.dat.bz2
Steps
Install the additional libraries from the repository root with pip install -r requirements.txt.
Download and unpack the face-landmark model into the main project directory.
Start the application by running zad2.py.
Expected outcome
The documented application is started for camera-based face swapping using a provided face image.
Guide limitations
- The README does not specify operating-system or hardware requirements.
- Some project data is third-party material and is not covered necessarily by the code's MIT licence.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- MarekKowalski/FaceSwap · Official homepage title · retained in its source language

