GFPGAN环境搭建终极指南：从零开始构建人脸修复开发环境

【免费下载链接】GFPGAN TencentARC/GFPGAN: GFPGAN（GFPGAN: Real-World Blind Face Restoration with PULSE++）是由腾讯ARC实验室研发的一个基于深度学习的人脸图像修复工具，主要用于低质量人脸图像的超分辨率恢复。 项目地址: https://gitcode.com/gh_mirrors/gf/GFPGAN

GFPGAN（GFPGAN: Real-World Blind Face Restoration with PULSE++）是由腾讯ARC实验室研发的基于深度学习的人脸图像修复工具，主要用于低质量人脸图像的超分辨率恢复。本指南将帮助新手和普通用户从零开始搭建GFPGAN开发环境，轻松实现老旧照片的人脸修复。

为什么选择GFPGAN进行人脸修复？

GFPGAN作为一款专业的人脸修复工具，能够有效解决老照片模糊、失真、低分辨率等问题，让珍贵的回忆重现清晰。无论是家庭老照片修复，还是历史影像增强，GFPGAN都能提供高质量的修复效果。

图：GFPGAN人脸修复效果展示，左侧为模糊人脸，右侧为修复后清晰人脸

准备工作：环境要求与依赖项

在开始搭建GFPGAN环境之前，请确保你的系统满足以下要求：

• 操作系统：Linux（推荐Ubuntu 18.04及以上版本）
• Python版本：3.7及以上
• 硬件要求：建议配备NVIDIA显卡（支持CUDA加速），以获得更好的修复性能

GFPGAN的主要依赖项包括：

• basicsr>=1.4.2
• facexlib>=0.2.5
• torch>=1.7
• numpy、opencv-python、pyyaml等

这些依赖项将在后续步骤中自动安装。

第一步：克隆GFPGAN仓库

首先，打开终端，执行以下命令克隆GFPGAN仓库：

git clone https://gitcode.com/gh_mirrors/gf/GFPGAN
cd GFPGAN

第二步：创建并激活虚拟环境

为了避免依赖冲突，建议使用虚拟环境来安装GFPGAN。执行以下命令创建并激活虚拟环境：

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境（Linux/Mac）
source venv/bin/activate

# 激活虚拟环境（Windows）
venv\Scripts\activate

第三步：安装依赖项

进入GFPGAN目录，执行以下命令安装所需依赖：

pip install -r requirements.txt

requirements.txt文件中包含了GFPGAN运行所需的所有依赖包，包括PyTorch、OpenCV等。

第四步：下载预训练模型

GFPGAN需要预训练模型才能进行人脸修复。模型会在首次运行时自动下载，也可以手动下载并放置到指定目录。模型下载路径可在inference_gfpgan.py文件中查看，主要模型包括：

• GFPGANv1.3.pth
• GFPGANv1.4.pth
• RestoreFormer.pth

这些模型将被保存在gfpgan/weights/目录下。

第五步：运行GFPGAN进行人脸修复

环境搭建完成后，可以使用以下命令运行GFPGAN进行人脸修复：

python inference_gfpgan.py -i inputs/whole_imgs -o results -v 1.3 -s 2

参数说明：

• -i：输入图片或文件夹路径，默认为inputs/whole_imgs
• -o：输出结果文件夹，默认为results
• -v：GFPGAN模型版本，可选1、1.2、1.3、1.4或RestoreFormer，默认为1.3
• -s：图像最终放大倍数，默认为2

图：GFPGAN输入示例，一张需要修复的老照片

第六步：查看修复结果

修复完成后，结果将保存在results目录下，包括：

• cropped_faces：裁剪出的人脸区域
• restored_faces：修复后的人脸
• restored_imgs：完整修复后的图像
• cmp：修复前后对比图

图：GFPGAN输入示例，另一张需要修复的老照片

常见问题解决

1. 依赖安装失败：如果出现依赖安装失败的情况，可以尝试更新pip或单独安装失败的包。

2. CUDA out of memory：如果出现显存不足的问题，可以尝试减小输入图像尺寸或降低模型版本。

3. 模型下载缓慢：可以手动下载模型并放置到gfpgan/weights/目录下。

总结

通过以上步骤，你已经成功搭建了GFPGAN人脸修复开发环境。现在，你可以使用GFPGAN来修复老旧照片，让珍贵的回忆重现清晰。无论是家庭老照片修复，还是历史影像增强，GFPGAN都能为你提供强大的支持。

希望本指南对你有所帮助，祝你在人脸修复的道路上取得成功！

【免费下载链接】GFPGAN TencentARC/GFPGAN: GFPGAN（GFPGAN: Real-World Blind Face Restoration with PULSE++）是由腾讯ARC实验室研发的一个基于深度学习的人脸图像修复工具，主要用于低质量人脸图像的超分辨率恢复。 项目地址: https://gitcode.com/gh_mirrors/gf/GFPGAN