5 分钟跑通 Roop-Unleashed：免训练换脸视频与图片的完整入门指南
【免费下载链接】roop-unleashedEvolved Fork of roop with Web Server and lots of additions项目地址: https://gitcode.com/gh_mirrors/ro/roop-unleashed
你想不写一行训练代码，只拿一张照片，就把视频里演员的脸换成另一张脸，还能顺手把画质增强、把嘴型遮挡处理掉？这正是 Roop-Unleashed 要解决的问题：它是一款基于 Gradio 的 Web 换脸工具，图片和视频都支持，全程在浏览器里点鼠标完成。
它到底是什么？Roop-Unleashed 能帮你做什么
一句话定位：Roop-Unleashed 是一个带浏览器界面的"无训练换脸"工作站，换脸、增强、裁剪、实时假摄像头全部在一个页面上搞定。
| 功能 | 说明 |
|---|---|
| 图片/视频换脸 | 上传一张源人脸照片 + 目标图片或视频，自动逐帧替换 |
| 多脸与多种换脸模式 | 支持多张源脸、多人脸目标，可按检测顺序、手动选择或性别挑选 |
| 人脸增强 | 内置 CodeFormer、GFPGAN、GPEN、DMDNet、RestoreFormer++ 等多种"美颜修复"模型 |
| 遮挡处理与批量处理 | 用文本提示或自动算法遮罩被头发/手遮挡的部分，一次丢进多个文件 |
| 实时假摄像头 | 接上你的 Webcam，输出实时换脸后的"虚拟摄像头"画面 |
它和网上那些"传照片等结果"的网站不同：模型跑在你自己的电脑上，素材不出本机。
5 分钟跑起来：克隆、装依赖、启动
前提：机器上已有 Python 3.9+ 和 Git，视频处理还需要安装 ffmpeg（缺失时程序会明确提示）。
先拿到代码，这条命令把项目克隆到本地并进入目录：
git clone https://gitcode.com/gh_mirrors/ro/roop-unleashed cd roop-unleashed再安装依赖，这一行会装上 PyTorch、Gradio、InsightFace 等全部运行组件（体积较大，耐心等待）：
pip install -r requirements.txt最后启动服务：
python run.py首次启动会自动下载约 2GB 的模型文件到models/目录，属于正常现象；进度条走完、浏览器自动打开后，你就能看到换脸主界面了。
不同系统入口略有差别：Windows 用户可直接运行 Installer 里的
windows_run.bat，macOS 用户执行sh runMacOS.sh，仓库里也提供了 Dockerfile 供容器化部署。
实战场景：三个最常见的用法
场景一：给一段视频换脸（最常用）
什么时候用：把一段表演视频里的主角换成指定的人脸照片。
怎么操作：进入 Face Swap 页签，左侧上传源人脸照片（程序会自动裁出人脸缩略图），下方"Target File(s)"放入视频，右侧预览区拖动"Frame Number"滑杆挑选参考帧，确认后点橙色的 Start。
注意什么：预览时先用"Face swap frames"抽几帧检查效果，再整段跑；处理完的成品默认输出到output/目录，页面里的"Open Output Folder"可以直接打开。
场景二：批量处理多张照片
什么时候用：手里有一堆合影或角色立绘，想一次性把某张脸全部替换。
怎么操作：目标区支持一次添加多张图片，换脸模式选 "All input faces" 或手动指定某张源脸，其余参数与视频流程一致。
注意什么：批量任务的耗时会随图片数量线性增长，先挑 1~2 张验证"Max Face Similarity Threshold"（相似度阈值）是否合适，再放全部文件。
场景三：实时换脸假摄像头
什么时候用：视频会议或直播时，想把自己（或指定脸）实时输出给其他软件。
怎么操作：切到 Live Cam 页签，选择源人脸，程序会调用摄像头并把逐帧换脸后的画面作为虚拟摄像头输出。
注意什么：实时模式对显卡压力最大，建议优先使用 CUDA 环境；换脸模型若用 GPU 专用增强（如 DMDNet）请确认本机是 NVIDIA 显卡。
进阶与周边生态：它借了谁的力量？
Roop-Unleashed 本身是一个"组装层"，换脸与增强的核心能力来自几个独立项目，了解它们能帮你按需调参：
- InsightFace：负责人脸检测与基础换脸模型，界面上"Selected face"等模式背后就是它在识别五官关键点。
- GFPGAN / CodeFormer / GPEN / DMDNet / RestoreFormer++：一组可选的人脸增强器，在
roop/processors/目录中各占一个模块文件，分别擅长不同风格——CodeFormer 偏自然，GFPGAN 偏锐利，RestoreFormer++ 适合低清老片修复。 - ReSwapper：v4.4 引入的备选换脸模型，支持 128px 与 256px 输出，需要更高分辨率时可切换。
- Stable Diffusion WebUI：换脸之后的下游玩法（风格化、重绘）常配合它完成，两者各司其职。
界面里的所有参数最终会保存到config.yaml，修改settings.py对应的字段也能做持久化配置。
新手最常踩的 3 个坑
- 第一次启动"卡住"不动：其实在下载约 2GB 模型，不是死机；网络不好就耐心等，或手动把模型放进
models/目录再启动。 - 提示 ffmpeg 未安装：换脸引擎靠 ffmpeg 拆帧和合成视频，装好 ffmpeg 并加入 PATH 后重启程序即可。
- 选了 CUDA 却报 GPU 相关错误：没有 NVIDIA 显卡（或 CUDA 版本低于 12.4）时，到 Settings 页签把 provider 改回 CPU 再重启，速度会变慢但能正常跑通。
写在最后
Roop-Unleashed 把"换脸"这件事从命令行搬进了浏览器：克隆、装依赖、启动，三步之后你就能在本地完成从单图到视频、从批量到实时的全套操作。
下一步建议：先按上面的流程启动一次，用一张自拍和一段 10 秒的短视频跑通最小闭环，再去 Settings 里逐个试用五种增强器，感受它们各自的效果差异。
提醒：请仅在技术学习与授权范围内使用，涉及真实人脸时务必取得本人同意，并在发布内容时明确标注为 AI 生成。
【免费下载链接】roop-unleashedEvolved Fork of roop with Web Server and lots of additions项目地址: https://gitcode.com/gh_mirrors/ro/roop-unleashed
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
