roop-unleashed：免训练 AI 换脸工具，完整安装与使用指南

roop-unleashed免训练 AI 换脸工具完整安装与使用指南【免费下载链接】roop-unleashedEvolved Fork of roop with Web Server and lots of additions项目地址: https://gitcode.com/gh_mirrors/ro/roop-unleashed把指定人物的脸放到照片或视频里不需要自己训练模型。roop-unleashed 是一款免费开源的 AI 换脸工具启动后在浏览器里操作基于预训练模型直接出效果支持单图、视频和实时摄像头换脸适合内容创作者和技术爱好者。功能一览roop-unleashed 能做什么roop-unleashed 是从 roop 演化而来的分支项目核心处理代码在 roop/processors/ 目录界面基于 Gradio 构建所有操作都在浏览器中完成不需要敲命令行。主要能力免训练换脸内置 InSwapper、ReSwapper 等预训练模型下载完成即可出图。浏览器界面运行后启动本地 Web 服务任意浏览器打开即可Windows、macOS、Linux 通用。批量处理一次添加多张图片和多个视频顺序完成处理。多种选脸模式提供 First found、Selected face、All input faces、按性别选择等 7 种换脸模式。人脸增强可选 Codeformer、GFPGAN、GPEN、DMDNet、Restoreformer 5 种后置增强算法。智能遮罩用文字描述或 DFL XSeg 模型识别遮挡物保护这些区域不被替换。Live Cam调用摄像头做实时换脸配合虚拟摄像头输出。图中是 Face Swap 标签页左侧管理输入脸、源文件与目标文件中间是换脸模型、阈值、增强器等参数右侧为预览区和最终结果。安装与运行Windows、macOS、Linux 分平台步骤环境要求操作系统Windows、Linux、macOS或使用 Docker。Python 3.9 及以上启动时自动检查低于 3.9 会提示升级。FFmpeg视频处理依赖它未安装时程序会在启动时警告。GPU可选 NVIDIA 显卡需 CUDA 12.4 及以上没有 GPU 时程序自动回落到 CPU。安装步骤三个平台都先克隆仓库git clone https://gitcode.com/gh_mirrors/ro/roop-unleashed cd roop-unleashedWindows双击 installer/windows_run.bat。脚本会自动安装 Miniconda 和 FFmpeg然后下载依赖并启动程序。macOSsh runMacOS.sh首次运行前可先执行 installer/macOSinstaller.sh 自动检查并安装依赖。Linuxpip install -r requirements.txt python run.pyDockerdocker build -t roop-unleashed . docker run -t -p 7860:7860 -v ./models:/app/models -v ./output:/app/output roop-unleashed注意首次运行会下载约 2GB 的预训练模型请保持网络稳定模型保存在 models/ 目录之后不再重复下载。服务默认监听 7860 端口并自动打开浏览器。Settings 标签页会把你的配置写入 config.yaml下次启动自动沿用。分场景使用图片、视频、实时换脸场景一单张图片换脸需要准备一张清晰的源脸照片以及一张待替换的目标图片。操作步骤在浏览器界面打开 Face Swap 标签页。把源脸图片上传到 Source Images or Facesets。把目标图片上传到 Target File(s)。在右侧预览区查看效果不满意可调整参数后刷新预览。点击 Start结果出现在 Processed File(s) 区域文件默认保存在 output/ 目录。关键参数参数默认值说明Max Face Similarity Threshold0.650.0 仅换几乎相同的脸1.0 任何脸都换Select post-processingNone选择增强器None 表示不增强blend ratio0.65原图与增强图的混合比例仅在开启增强时生效场景二视频换脸需要准备目标视频文件以及已安装的 FFmpeg。操作步骤把视频上传到 Target File(s)程序会自动检测各帧人脸。拖动预览区的帧滑块检查不同帧的换脸效果。需要局部处理时用 Set as Start / Set as End 设定帧范围。点击 Start处理完成后程序自动把原音轨合回视频输出到 output/ 目录。关键参数参数默认值说明Select video processing methodIn-Memory processing内存处理或抽帧到磁盘大视频建议用抽帧Action on no face detectedUse untouched original frame可选旋转重试、跳过、沿用上次换脸结果等Video FPS00 表示保持原帧率否则强制覆盖Skip audio关勾选后输出不保留音轨如果脸被手、杯子等物体遮挡可在 Advanced Masking 中选择 Clip2Seg 引擎用文字描述遮挡物默认示例为 cup,hands,hair,banana这些区域会保留原样。场景三Live Cam 实时换脸需要准备可用的摄像头和一张源脸照片。操作步骤切换到 Live Cam 标签页。上传源脸照片并选择摄像头。启动后界面中实时显示换脸效果可直接用于演示或视频通话场景。换脸输出方式的选项在 Face Swap 标签页的 Select Output MethodFile、Virtual Camera、Both 三种可把结果直接送进虚拟摄像头。实时帧率取决于你的硬件配置以实际运行环境为准。关键参数调优相似度阈值、增强器、混合比例1. Max Face Similarity Threshold人脸相似度阈值范围 0.01–1.0默认 0.65。值越小匹配越严格只换与源脸很像的脸适合多人同框、避免换错。值越大越宽松目标脸角度、光线变化大时也能换上去。建议从默认值开始出现误换就调低 0.1漏换就调高。2. Select post-processing增强器选择共 6 个选项None、Codeformer、DMDNet、GFPGAN、GPEN、Restoreformer。DMDNet 只能在 CUDA 环境下工作Restoreformer 是 v3.5.5 引入的增强器。开启增强后配合 blend ratio 调节比例越高增强效果越明显越低越贴近原脸质感。3. Subsample upscale to子采样放大三个档位128px、256px、512px默认 128px。用于提高换脸输出分辨率档位越高占用越多显存。性能参考与硬件说明官方资料中没有公布基准测试数据处理速度随硬件、视频分辨率和处理参数变化以实际运行环境为准。可关注以下几点GPU 用户需要 CUDA 12.4 及以上版本这是 v4.4.0 起的官方要求。没有 NVIDIA 显卡时程序自动使用 CPU无需手动设置。设置中 max_threads 默认 2memory_limit 可限制内存占用适合低配置机器。首次运行下载约 2GB 模型只发生一次。常见问题FFmpeg 缺失、首次下载、误换脸问题 1启动时提示ffmpeg is not installed视频功能不可用现象视频处理直接失败或启动时报警告。可能原因系统没有安装 FFmpeg。解决方案安装 FFmpeg 后重启程序Windows 用户重新运行安装脚本会自动处理。问题 2第一次启动等待时间很长现象程序卡在启动阶段。可能原因正在下载约 2GB 的预训练模型。解决方案保持网络稳定模型保存到 models/ 目录第二次启动不再下载。问题 3换错了脸或检测不到脸现象结果中换了错误的面孔或目标帧没有换脸。可能原因源图模糊或有遮挡、目标中人脸太多、阈值过松。解决方案换一张清晰、正脸、单人照片作为源图调低相似度阈值改用 Selected face 模式手动指定要替换的目标脸。问题 4低配置电脑处理很慢现象逐帧处理耗时明显。可能原因CPU 模式下跑大视频且开启了增强。解决方案降低输出分辨率、关闭后置增强、在设置中调低 max_threads 并开启 memory_limit 限制内存。伦理与合规换脸使用红线README 明确说明本项目仅用于技术和学术目的开发者不对使用者的行为负责。硬性规则如下使用真实人物的脸之前先获得本人的明确同意。发布内容时标注deepfake或AI 生成。不得用于欺诈、诽谤或其他违法场景。遵守所在地法律法规对行为后果自负。发布前自检三项内容中的每张脸是否都取得了本人同意是否已显著标注 AI 生成或深度伪造发布目的和场景是否合法不损害他人名誉、隐私与肖像权从单图换脸开始roop-unleashed 把预训练模型、浏览器界面和多种后处理整合在一个开源项目里让你跳过训练环节直接得到换脸结果。建议的下一步按上面步骤克隆仓库并运行安装脚本先完成一次单图换脸再尝试短视频处理和各种增强器。【免费下载链接】roop-unleashedEvolved Fork of roop with Web Server and lots of additions项目地址: https://gitcode.com/gh_mirrors/ro/roop-unleashed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考