v3.0.0

honojs/honov3.0.0Dec 21, 2025by torzdf

AI Summary

This release provides installers for Faceswap.py on Windows, Linux, and macOS. The installers automatically set up the environment by downloading prerequisites like Git, MiniConda, and PyTorch, and create desktop shortcuts for the GUI. It supports Nvidia GPUs with CUDA 11.8+ and AMD GPUs with ROCm 6.0-6.4.

Key Highlights

  • Cross-platform support for Windows, Linux, and macOS
  • Automatic installation of prerequisites (Git, MiniConda, PyTorch)
  • Nvidia GPU support with CUDA 11.8+ capability
  • AMD GPU support via ROCm 6.0-6.4
  • Automatic creation of desktop shortcuts for the FaceSwap GUI

New Features

  • Automatic prerequisite installation
  • PyTorch backend support
  • AMD GPU support via ROCm
  • Desktop shortcut creation

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```