v3.0.0

deepfakes/faceswapv3.0.0Dec 21, 2025by torzdf

AI Summary

Major release transitioning Faceswap from TensorFlow to PyTorch backend with improved GPU support. This installer automates setup of all prerequisites including Git, MiniConda, PyTorch, CUDA and cuDNN for Nvidia users, while AMD users require ROCm 6.0-6.4.

Key Highlights

  • Transitioned from TensorFlow to PyTorch backend
  • Added native macOS support with install script
  • CUDA 11.8+ required for Nvidia GPUs
  • ROCm 6.0-6.4 required for AMD GPUs (via WSL2 on Windows)
  • Creates Desktop shortcut for GUI launch

Breaking Changes

  • AMD cards no longer supported natively on Windows - requires WSL2
  • TensorFlow backend deprecated in favor of PyTorch

New Features

  • Automated installation of all prerequisites
  • PyTorch with CUDA 11.8+ support
  • ROCm support for AMD graphics cards
  • Cross-platform installer (Windows, Linux, macOS)

Full Release Notes

**Installer for Faceswap.py**

This installer will install missing prerequisites (Git, MiniConda, PyTorch), set up the environment and create a Desktop shortcut for launching straight into the FaceSwap GUI. If running this installer, you do not need to manually install any programs yourself.

For **Nvidia** users it will install a local version if CUDA and cuDNN into a Conda environment. A CUDA 11.8+ capable graphics card is required.

For **AMD** Users The ROCm version of Torch will be installed, but you will need to ensure that you have ROCm 6.0-6.4 installed to enable use of AMD Graphics cards.

# Windows Users
**Note: Only Nvidia + CPU are supported under Windows. To use AMD cards, you will need to use Windows Subsystem for Linux (WSL2) and run the ROCm version of Faceswap.**

You only need to download the file [faceswap_setup_x64.exe](https://github.com/deepfakes/faceswap/releases/latest/download/faceswap_setup_x64.exe) from this page. You should **not** run the installer as an Administrator.

**NB:** It may, at times, look like the installer has hung. It hasn't. The installer has to download and install a lot of prerequisites, and it is impossible to retrieve a live update of the output into the Details window. Please be patient.

**IMPORTANT**: Windows SmartScreen may flag this program as unsafe. This is because it needs to download third party applications from the internet. It is entirely safe, and the source code can be reviewed here: https://github.com/deepfakes/faceswap/tree/master/.install/windows If you are still not convinced, you can review the source code and compile the installer yourself.

# Linux Users
You only need to download the file [faceswap_setup_x64.sh](https://github.com/deepfakes/faceswap/releases/latest/download/faceswap_setup_x64.sh) from this page.

Just download and run as a normal user:
```bash ./faceswap_setup_x64.sh```
Then follow the prompts.

# Mac Users
Just run the following command in `Terminal` to download and run the install script:
```
bash <(curl -s https://github.com/deepfakes/faceswap/releases/latest/download/faceswap_setup_macos.sh)
```
Then follow the prompts

If the above doesn't work, then download the file  [faceswap_setup_macos.sh](https://github.com/deepfakes/faceswap/releases/latest/download/faceswap_setup_macos.sh) from this page then execute as a normal user:

```bash ./faceswap_setup_macos.sh```