FaceFusion 2.x/3.x 在 macOS 上的完整安装、配置与使用指南

作者: memory

时间: 2024-09-15

分类: 工具使用

请勿用于非法用途哟！

1. 安装必要工具

在安装 FaceFusion 前，确保安装以下工具：

Git：版本控制工具
```
brew install git
```
Miniconda：Python 虚拟环境管理工具
```
brew install miniconda
conda init --all
```
FFmpeg：处理音视频
```
brew install ffmpeg
```

2. 创建并激活虚拟环境

conda create --name facefusion python=3.10
conda activate facefusion

3. 克隆 FaceFusion 仓库

git clone https://github.com/facefusion/facefusion
cd facefusion

4. 安装应用程序

FaceFusion 分为 2.x 和 3.x 版本，安装命令有所不同：

2.x 版本安装：
```
python install.py
```
3.x 版本安装：
```
python install.py --onnxruntime default
```

5. 运行应用程序并下载模型

首次运行会自动下载模型文件，以下是不同版本的运行方式：

2.x 版本运行：
```
python run.py
```
3.x 版本运行：
```
python facefusion.py run
```

示例下载输出：

Downloading: 100%|===========================| 8.00/8.00 [00:01<00:00, 7.11B/s, file=open_nsfw.hash]
Downloading: 100%|===========================| 22.5M/22.5M [00:05<00:00, 4.30MB/s, file=open_nsfw.onnx]
Downloading: 100%|===========================| 8.00/8.00 [00:01<00:00, 5.46B/s, file=fairface.hash]
Downloading: 100%|===========================| 81.2M/81.2M [00:27<00:00, 3.09MB/s, file=fairface.onnx]
Downloading: 100%|===========================| 8.00/8.00 [00:01<00:00, 5.59B/s, file=yoloface_8n.hash]
Downloading: 100%|===========================| 12.1M/12.1M [00:16<00:00, 777kB/s, file=yoloface_8n.onnx]
Downloading: 100%|===========================| 8.00/8.00 [00:00<00:00, 9.43B/s, file=fan_68_5.hash]
Downloading: 100%|===========================| 8.00/8.00 [00:01<00:00, 5.29B/s, file=2dfan4.hash]
Downloading: 100%|===========================| 922k/922k [00:01<00:00, 571kB/s, file=fan_68_5.onnx]
Downloading:  89%|=================== | 82.7M/93.4M [03:16<00:08, 1.33MB/s, file=2dfan4.onnx]

6. 使用 FaceFusion

FaceFusion 默认在本地 localhost:7860 端口启动，你可以通过浏览器访问此网址。建议启用以下选项：

face_swapper：面部替换
frame_enhancer：帧增强
face_enhancer：面部增强

7. 解决依赖冲突

如果遇到依赖问题，例如：

gradio 3.50.2 requires numpy~=1.0, but you have numpy 2.1.1...

可通过以下命令升级 gradio：

pip install --upgrade gradio

遇到 SOCKS 代理相关错误：

ImportError: Using SOCKS proxy, but the 'socksio' package is not installed...

解决方法：

pip install 'httpx[socks]'

8. 常用命令选项

你可以使用 python run.py --help 查看所有可用选项。以下是一些常见命令及说明：

-s (source)：指定源文件路径。
```
python run.py -s path/to/source
```
-t (target)：指定目标文件路径。
```
python run.py -t path/to/target
```
-o (output)：指定输出文件或目录。
```
python run.py -o path/to/output
```
--frame-processors：启用特定帧处理器，如面部替换和增强。
```
python run.py --frame-processors face_swapper frame_enhancer face_enhancer
```
--execution-providers：选择处理设备（例如 cpu）。
```
python run.py --execution-providers cpu
```
--open-browser：启动后自动打开浏览器。
```
python run.py --open-browser
```
--log-level：设置日志级别（如 info 或 debug）。
```
python run.py --log-level info
```