Also available in 中文 English

roop 是一个曾经很流行的开源 AI换脸 项目。早期独立版只需要一张来源人脸,就可以处理图片和视频,不需要针对每个人重新训练专属模型。

roop 在 2023 年停止开发,目前官方 GitHub 仓库已经归档。现在仓库里的内容主要是 Stable Diffusion AUTOMATIC1111 WebUI 的图片换脸扩展,和早期通过 python run.py 启动的视频换脸程序不是同一套使用方式。

roop AI换脸是什么?

roop 最早是一套基于 Python 的本地人脸替换工具。

准备一张包含来源人脸的照片,再选择目标图片或视频,就可以进行人脸替换。

它当年比较特别的一点,是不需要像传统 Deepfake 工作流那样,为某个人准备大量素材,再花时间单独训练模型。一张比较清晰的来源照片就能开始处理,这也是 roop 很快受到关注的原因之一。

roop 早期视频换脸效果演示

roop 为什么停了?

roop 在 2023 年停止开发。作者后来表示,他重新考虑了这类生成式媒体工具可能带来的影响,因此决定结束项目。

现在 GitHub 仓库已经归档,只保留代码供查看。

roop 现在还能用吗?

早期 roop 代码并不是完全不能运行,但能不能正常使用,很依赖当时的运行环境。

Python、ONNX Runtime、InsightFace、FFmpeg、模型文件、显卡驱动和操作系统版本都可能影响旧版程序。已经保留旧环境的用户可能还能继续运行,从零重新安装则更容易碰到依赖冲突、模型文件变化或者兼容性问题。

这里还要区分两个版本:早期独立版可以处理图片和视频;现在官方 GitHub 仓库中的代码主要是 Stable Diffusion AUTOMATIC1111 WebUI 的图片换脸扩展,并不是当年的独立视频换脸程序。

为什么以前的 roop 安装教程失效了?

早期独立版 roop 是一个 Python 程序,常见的安装方式是准备 Python、Git、pip 和 FFmpeg,安装依赖后通过:

python run.py

启动。

完整流程通常类似:

git clone https://github.com/s0md3v/roop
cd roop
pip install -r requirements.txt
python run.py

但现在官方仓库中已经没有这个 run.py 入口。

当前仓库保留的是 Stable Diffusion WebUI 扩展相关代码,README 中的安装方式也是通过 AUTOMATIC1111 的 Extensions 功能加载扩展。

所以现在打开 GitHub 后发现文件和以前的 roop 教程对不上,并不是少装了某个组件,而是仓库里的项目形态已经变了。

roop 早期安装界面(2023)

roop 早期启动界面(2023)

仍在维护的本地换脸项目

如果现在是从零搭建本地图片或视频换脸环境,可以再看看仍在维护的同类项目。

Rope 更偏向图形界面操作,也是从 roop 这类本地换脸工作流发展出来的项目。截至 2026 年 10 月,其 GitHub 仓库仍未归档。

GitHub:https://github.com/Hillobar/Rope

FaceFusion 也是目前仍在开发的人脸处理项目,覆盖图片和视频工作流,GitHub 仓库目前同样处于活跃状态。

GitHub:https://github.com/facefusion/facefusion

Rope 和 FaceFusion 都不是 roop 的官方继任版本,只是现在还可以继续研究的同类项目。

roop 的许可证和模型授权

roop 当前 GitHub 仓库的代码使用 AGPL-3.0 许可证,但代码开源不代表换脸模型也采用同样的授权方式。

roop 使用过 InsightFace 的 inswapper_128.onnx 换脸模型。

InsightFace 的项目代码和预训练模型采用不同的许可方式。其代码使用 MIT License,而预训练模型有单独的使用条件,inswapper 系列模型如果涉及商业用途,需要另外确认授权。

如果准备把这类工作流用于商业产品、在线服务或者企业项目,不能只看 roop 仓库自己的 AGPL-3.0,还要确认实际使用模型的授权条件。

使用 roop 前要注意什么?

AI 换脸可以用于图片编辑、视频制作和技术测试,但涉及真实人物时,需要确认自己有权使用相关照片和视频。

不要使用未经允许的人脸制作冒充、欺骗或容易误导他人的内容,也不要把换脸结果用于身份验证等需要确认真人身份的场景。

如果只是测试工具,可以优先使用自己的照片,或者已经取得使用许可的素材。

roop 常见问题

roop 需要自己训练模型吗?

早期 roop 不需要针对每个人重新训练专属模型。准备一张来源人脸后,就可以直接进行替换。

roop 现在还支持视频换脸吗?

要看具体版本。早期独立版 roop 支持视频换脸;当前官方 GitHub 仓库里的代码主要是 Stable Diffusion WebUI 图片换脸扩展,不是原来的独立视频程序。

roop GitHub 地址

官方 GitHub:https://github.com/s0md3v/roop

本文由(ahhhhfs.com)根据项目官网、官方文档及公开资料整理。工具的功能、价格、授权与服务条款可能调整,请以官方最新说明为准。合理引用请注明来源并保留本文链接;如需全文转载,或发现内容错误、版权及授权问题,可通过 feedback#abskoop.com「联系我们」反馈(请将 # 替换为 @)。