roop for StableDiffusion

roop for StableDiffusion 是挂在 StableDiffusion 的 AUTOMATIC1111 web-ui 上的一个扩展，用来在生成的图片里替换人脸。装好之后 web-ui 里会多出一个 roop 下拉菜单，导入一张带脸的图片，勾上 Enable，之后生成的结果就会用上这张脸。它基于 roop 项目改写，作者说会单独维护。

主要功能

核心动作只有两步：选脸、启用。想换得更像，可以打开 Restore Face，或者用 Upscaler 选项；要更细的控制，可以到 Extras 标签里再放大一次。作者还建议配合 img2img，把 denoise 从 0.1 起步慢慢往上调，在画质和相似度之间找平衡。

一张图里有多张脸时，可以在「Comma separated face number(s)」里填人脸编号，指定换哪几张。如果脸没换成功，先确认 Enable 有没有勾上；控制台没报错的话，多半是图片被判定为 NSFW，或者根本没检测到人脸。

安装与限制

安装要自己动手：Windows 上先装 Visual Studio 并勾上 Python 和 C++ 组件，执行 pip install insightface==0.7.3，再在 web-ui 的 Extensions 里用仓库地址从 URL 安装，装完重启。遇到 'NoneType' object has no attribute 'get' 报错，需要手动下载 inswapper_128.onnx 模型放进 models/roop/ 目录。作者在 README 里明确说，装不上别来提 issue，自己去搜报错。

这个仓库已经被作者归档，2026 年 5 月 17 日起只读，不再接受 pull request。作者的说法是，最初只把它当生成媒体的技术实验，发布后对这类软件带来的二阶影响改变了看法，于是停止开发。软件内置了检查，会拒绝处理不合适的素材；README 也提醒，用真人脸要取得本人同意，发布内容时标明是 deepfake。

适合谁

已经在用 AUTOMATIC1111 web-ui、想给生成图换脸的人。需要自己配环境、看报错，不适合想开箱即用的人；项目已停更，后续不会再有修复和新功能。