一、前期准备:必备基础环境
官方文档:FaceFusion
在开始 FaceFusion 的部署前,需确保本地环境已安装以下基础工具,这是顺利运行项目的前提:
- 包管理工具:conda(Anaconda/Miniconda 均可)
- 代码克隆工具:git
- 音视频处理工具:ffmpeg
上述工具均为开源免费,可根据自身操作系统(Windows/macOS/Linux)从官方渠道下载安装,常规默认配置即可满足使用需求。
二、环境搭建:一步一步教你配置
FaceFusion 对 Python 版本有明确要求,推荐使用 conda 创建独立虚拟环境,避免与本地其他项目的环境产生冲突,以下是全平台通用的配置命令,Windows 用户可使用 CMD/PowerShell,macOS/Linux 用户使用终端执行。
2.1 虚拟环境创建与依赖安装
# 初始化 conda(首次使用执行,后续可跳过)
conda init --all
# 创建名为 facefusion 的虚拟环境,指定 Python3.12、pip25.0
conda create --name facefusion python=3.12 pip=25.0 -y
# 激活虚拟环境
conda activate facefusion
# 安装 tensorrt(NVIDIA 显卡加速依赖,无 N 卡可跳过此步)
pip install tensorrt==10.12.0.36 --extra-index-url https://pypi.nvidia.com
# 克隆 FaceFusion 项目到本地
git clone https://github.com/facefusion/facefusion
# 进入项目根目录
cd facefusion
# 安装项目依赖,指定 onnxruntime 的 cuda 版本(无 N 卡替换为 cpu)
python install.py --onnxruntime cuda
2.2 项目启动与模型下载
完成依赖安装后,执行以下命令启动 FaceFusion,项目会自动打开本地浏览器,进入可视化操作界面:
# 重新激活虚拟环境(若终端会话中断)
conda deactivate
conda activate facefusion
# 启动项目并自动打开浏览器
python facefusion.py run --open-browser
首次启动时,项目会从 GitHub 和 HuggingFace 自动下载约 1.3G 的核心模型文件,模型会默认保存至项目根目录下,这是实现高精度换脸的关键,建议启动时开启网络代理提升下载速度。

启动之后大概是这样的:





