sd-webui-controlnet安装配置完全指南：兼容各种操作系统和硬件环境-优快云博客

sd-webui-controlnet安装配置完全指南：兼容各种操作系统和硬件环境

【免费下载链接】sd-webui-controlnet WebUI extension for ControlNet 项目地址: https://gitcode.com/gh_mirrors/sd/sd-webui-controlnet

简介

sd-webui-controlnet是Stable Diffusion WebUI的一个扩展，它允许Web UI将ControlNet添加到原始的Stable Diffusion模型中以生成图像。该扩展为AUTOMATIC1111的Stable Diffusion web UI设计，实现了基于注入方式的SD控制。

安装前准备

在开始安装sd-webui-controlnet之前，请确保您已经安装了Stable Diffusion WebUI。如果尚未安装，请先按照官方指南进行安装。

系统要求

Windows系统：推荐使用Windows 10或更高版本，配备NVIDIA显卡（Ampere架构及以上），至少4GB显存，并启用--xformers选项和UI中的"Low VRAM"模式，可支持最高768x832分辨率的生成。
MacOS系统：已在pytorch nightly版本上测试通过，使用mps和普通pytorch时，可能需要使用--no-half启动WebUI。

硬件要求

GPU：NVIDIA显卡（推荐Ampere架构及以上），至少4GB显存
CPU：多核处理器，推荐4核及以上
内存：至少8GB RAM
存储空间：至少10GB可用空间（用于安装和模型存储）

安装步骤

通过WebUI扩展安装

打开"Extensions"选项卡。
在该选项卡中打开"Install from URL"选项卡。
在"URL for extension's git repository"中输入https://gitcode.com/gh_mirrors/sd/sd-webui-controlnet。
点击"Install"按钮。
等待5秒钟，您将看到消息"Installed into stable-diffusion-webui\extensions\sd-webui-controlnet. Use Installed tab to restart"。
转到"Installed"选项卡，点击"Check for updates"，然后点击"Apply and restart UI"。（下次您也可以使用这些按钮来更新ControlNet。）
完全重新启动A1111 webui，包括您的终端。（如果您不知道什么是"终端"，可以重启计算机以达到相同的效果。）
下载模型（见下文）。
将模型放入正确的文件夹后，您可能需要刷新才能看到模型。刷新按钮位于"Model"下拉菜单的右侧。

手动安装

如果您无法通过WebUI扩展安装方法进行安装，可以尝试手动安装：

克隆仓库：

git clone https://gitcode.com/gh_mirrors/sd/sd-webui-controlnet.git extensions/sd-webui-controlnet

安装依赖：

cd extensions/sd-webui-controlnet
pip install -r requirements.txt

重启Stable Diffusion WebUI。

依赖安装

sd-webui-controlnet需要安装一些额外的依赖包。这些依赖会在安装过程中自动安装，但您也可以手动安装以确保所有依赖都正确安装。

主要依赖

主要依赖项在requirements.txt文件中列出，包括：

fvcore
mediapipe
opencv-python>=4.8.0
svglib
addict
yapf
albumentations==1.4.3
matplotlib
facexlib
timm<=0.9.5
pydantic<=1.10.17

安装脚本

安装过程由install.py脚本自动化处理，该脚本会根据系统环境安装适当的依赖项，包括onnxruntime或onnxruntime-gpu（基于CUDA的可用性）。

模型下载与配置

模型下载

您可以在Model download页面找到所有下载链接。

模型存放

下载完成后，将模型文件放入正确的文件夹中。默认情况下，模型应放在以下目录：

stable-diffusion-webui/extensions/sd-webui-controlnet/models

您可以在models/put_controlnet_models_here.txt文件中找到有关模型存放位置的说明。

模型刷新

将模型放入正确的文件夹后，您可能需要刷新才能在WebUI中看到模型。刷新按钮位于"Model"下拉菜单的右侧。

多操作系统配置

Windows系统配置

Windows系统的安装步骤与上述通用安装步骤相同。对于低显存用户，可以在启动命令中添加--xformers选项，并在UI中勾选"Low VRAM"模式。

MacOS系统配置

在MacOS上安装sd-webui-controlnet需要一些额外的步骤：

确保您使用的是pytorch nightly版本：

pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cpu

使用以下命令启动WebUI：
```
./webui.sh --no-half
```

命令行参数

sd-webui-controlnet为webui添加了以下命令行参数：

--controlnet-dir <path to directory with controlnet models>                                添加controlnet模型目录
--controlnet-annotator-models-path <path to directory with annotator model directories>    设置注释器模型目录
--no-half-controlnet                                                                       以全精度加载controlnet模型
--controlnet-preprocessor-cache-size                                                       controlnet预处理器结果的缓存大小
--controlnet-loglevel                                                                      controlnet扩展的日志级别
--controlnet-tracemalloc                                                                   启用malloc内存跟踪