roop

在 Stable Diffusion 里一键换脸，无需训练模型

roop 是一个 Stable Diffusion WebUI 的扩展插件，核心功能是实现一键换脸。它解决了在本地 Stable Diffusion 环境中无法直接进行高质量人脸替换的问题，用户无需训练模型，只需提供一张目标人脸图片，即可将生成图像中的人脸替换为指定人脸。该扩展基于 insightface 的人脸检测和识别能力，结合 GFPGAN 等修复模型，支持批量处理、人脸增强、超分辨率等选项，并提供了简单的 API 接口，方便集成到自动化流程中。roop 的核心优势在于操作简单、即装即用，适合快速生成换脸效果，但同时也引发了关于深度伪造的伦理讨论。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3560

维护状态低维护

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队s0md3v

所属国家

官网地址

GitHubhttps://github.com/s0md3v/roop

定价模式free

价格说明开源项目，基于AGPL-3.0许可证，可自由使用和部署，无付费版本。

访问状态

是否开源是

开源协议AGPL-3.0

主要语言Python

技术栈/模型stable-diffusion

GitHub 星标★ 3560

30天Star增速

HF 下载量

上线时间2023-06-17 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 15 分钟部署方式：本地安装 6 步

环境要求

已安装 AUTOMATIC1111 Stable Diffusion WebUI
Windows 上需安装 Visual Studio 并勾选 Python 和 C++ 相关组件
Python 环境可执行 pip 安装 insightface==0.7.3
inswapper_128.onnx 换脸模型文件（遇到报错时需要）

安装与启动步骤

1安装 Visual Studio

Windows 用户先下载安装 Visual Studio，安装过程中务必勾选 Python 和 C++ 相关包，否则后续依赖可能编译失败。
2安装 insightface

在 webui 所使用的 Python 环境中执行。若环境不匹配会装到错误的解释器里。
```
pip install insightface==0.7.3
```
3安装扩展

打开 WebUI，进入 Extensions 标签页，在 install from URL 里填入扩展仓库地址并点击安装。
4重启 WebUI

安装完成后关闭 WebUI 再重新启动，扩展才会被加载生效。
5补下换脸模型

若出现 'NoneType' object has no attribute 'get' 报错，从 README 提供的链接下载 inswapper_128.onnx，放进 /models/roop/ 目录。
6使用换脸功能

在 roop 下拉菜单导入一张带人脸的图片，勾选 Enable，之后生成的图像就会替换成所选人脸。

关键配置

配置项	必填	说明	示例
`Enable`	是	roop 下拉菜单中的复选框，勾选后才启用换脸	`勾选（开启）`
`install from URL`	是	Extensions 标签页中用于从仓库地址安装扩展的输入框	`https://github.com/s0md3v/sd-webui-roop`
`inswapper_128.onnx`	否	换脸模型文件，出现 NoneType 报错时需手动下载放置	`/models/roop/inswapper_128.onnx`

如何确认成功

重启 WebUI 后，界面出现 roop 下拉菜单并显示 Enable 复选框，说明扩展安装成功。

常见问题

Q：报错 'NoneType' object has no attribute 'get' 怎么办？

A：这是缺少 inswapper_128.onnx 模型，按 README 链接下载后放入 /models/roop/ 目录，再重启 WebUI。

Q：安装过程中报其他错误怎么办？

A：README 明确说明：不要到项目 issue 区提问，请自行用搜索引擎检索错误信息解决。

Q：为什么仓库不能提交 PR？

A：该项目已被作者归档，归档后仓库不再接受 pull request，也不再继续开发。

Q：换脸功能在哪里开启？

A：在 WebUI 界面找到 roop 下拉菜单导入人脸图片，然后勾选 Enable 复选框即可。

注意事项

该项目已被作者归档，不再维护和更新，安装过程中遇到问题不会得到官方修复。
README 明确要求遇到安装错误自行搜索解决，不要提交 issue。
仅可用于合法合规用途；使用真人面孔需获得授权，并遵守当地法律。
README 提到软件内置检查会阻止对不当媒体进行处理，项目可能应法律要求关闭或为输出添加水印。

核心亮点

零训练成本：只需一张目标人脸图即可完成换脸，无需针对特定人物训练模型
无缝集成：作为 WebUI 扩展，安装后直接在界面操作，与现有生成流程融合
功能丰富：支持批量处理、人脸增强、超分、API 接口，适合自动化工作流

不足之处

换脸质量受源图角度和光照影响，复杂场景下可能出现瑕疵
文档/社区待观察：项目更新频率和文档完善度一般，依赖的 insightface 模型需自行下载

适用场景

创意设计：快速为生成的角色替换为特定人脸，用于概念设计或娱乐
内容创作：制作换脸视频或图片素材，用于短视频、表情包等
隐私保护：在分享生成图像时，用虚拟人脸替换真实人脸，保护隐私

替代项目

sd-webui-reactor、FaceSwap、DeepFaceLab

项目介绍

roop 是图像领域的开源项目，由 s0md3v 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,560）位列前 30%，在图像分类的 837 个项目里位列前 7%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。基于AGPL-3.0许可证，可自由使用和部署，无付费版本。

它主要面向的使用场景是：创意设计：快速为生成的角色替换为特定人脸，用于概念设计或娱乐。同类可对比的替代方案包括 sd-webui-reactor、FaceSwap、DeepFaceLab。

上一篇：discoart

下一篇：sd-webui-deforum