Install tkinter package (required for the GUI)

brew install python-tk@3.14

Install dependencies

pip install -r requirements.txt

** In case something goes wrong and you need to reinstall the virtual environment **

install the dependencies again

pip install -r requirements.txt

Installation (Manual)

Please be aware that the installation requires technical skills and is not for beginners. Consider downloading the quickstart version.

<details> <summary>Click to see the process</summary>

Installation

This is more likely to work on your computer but will be slower as it utilizes the CPU.

1. Set up Your Platform

• Python (3.14 recommended; 3.11-3.14 supported)
• pip
• git
• ffmpeg -

   (irm ffmpeg.tc.ht)

• Visual Studio 2022 Runtimes (Windows)

2. Clone the Repository

git clone --depth 1 https://github.com/hacksider/Deep-Live-Cam.git
cd Deep-Live-Cam

3. Download the Models

1. gfpgan-1024.onnx
2. inswapper\_128\_fp16.onnx

Place these files in the "models" folder.

4. Install Dependencies

We highly recommend using a venv to avoid issues.

For Windows:

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

Ensure you use the installed Python 3.14

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

**For macOS:**

Apple Silicon (M1 through M5) requires specific setup:

Install Python 3.14

brew install python@3.14

Reinstall the virtual environment

python -m venv venv source venv/bin/activate

Example: onnxruntime-openvino 1.24.1 pairs with OpenVINO 2025.4.1

pip install openvino==2025.4.1 pip install onnxruntime-openvino==1.24.1

See the [OpenVINO Execution Provider requirements](https://onnxruntime.ai/docs/execution-providers/OpenVINO-ExecutionProvider.html#requirements) for the full version-mapping details.

2. Usage:

Usage

1. Image/Video Mode

• Execute python run.py.
• Choose a source face image and a target image/video.
• Click "Start".
• The output will be saved in a directory named after the target video.

2. Webcam Mode

• Execute python run.py.
• Select a source face image.
• Click "Live".
• Wait for the preview to appear (10-30 seconds).
• Use a screen capture tool like OBS to stream.
• To change the face, select a new source image.

Create and activate virtual environment with Python 3.14

python3.14 -m venv venv source venv/bin/activate

Deactivate the virtual environment

rm -rf venv