-
该程序经过Python 3.10.6版本的测试。除非你想找麻烦，否则不要使用其他版本。
- 该程序需要16GB的常规RAM才能平稳运行。如果你只有8GB的RAM，考虑创建一个8GB的页面文件/交换文件，或者使用--lowram选项（如果你的GPU VRAM大于RAM）。
- 安装程序会创建一个Python虚拟环境，因此安装的模块不会影响现有的系统Python安装。
- 如果要使用系统的Python而不是创建虚拟环境，请使用自定义参数替换
set VENV_DIR=-。 - 要从头重新安装，请删除目录：
venv，repositories。 - 第一次启动程序时，会显示Python解释器的路径。如果这不是你安装的Python，你可以在
webui-user脚本中指定完整路径；参见Command-Line-Arguments-and-Settings#environment-variables。 - 如果所需的Python版本不在PATH中，请修改
webui-user.bat中的set PYTHON=python行，将其替换为Python可执行文件的完整路径。- 示例：
set PYTHON=B:\soft\Python310\python.exe
- 示例：
- 安装程序要求来自
requirements_versions.txt，该文件列出了与Python 3.10.6特定兼容的模块版本。如果这与其他Python版本不兼容，设置自定义参数set REQS_FILE=requirements.txt可能会有所帮助。
运行webui-user.bat但窗口立即关闭
发生了一些错误，但窗口关闭得太快，我们无法看到问题，我们需要阻止webui-user.bat立即关闭。
1. 右键点击编辑webui-user.bat。
2. 在文件末尾添加一个命令pause。
3. 保存修改并再次运行webui-user.bat。
webui-user.bat现在应该会暂停，让你看到问题。
修改后的文件应该类似于以下内容。（点击展开）
@echo off
set PYTHON=
set GIT=
set VENV_DIR=
set COMMANDLINE_ARGS=
call webui.bat
pause
低VRAM显卡
在具有较低VRAM（<=4GB）的显卡上运行时，可能会出现内存不足的错误。
可以通过命令行参数启用各种优化，以牺牲一些/大量速度来减少VRAM的使用：
- 使用--opt-sdp-no-mem-attention或可选依赖项--xformers，可以将许多显卡的GPU内存使用量减少一半。
- 如果你有4GB的VRAM，并且想要制作大约1.3倍大的图像，请使用--medvram。
- 如果你有4GB的VRAM，但使用--medvram时出现内存不足错误，请改用--lowvram --always-batch-cond-uncond。
- 如果你有4GB的VRAM，并且想要制作比--medvram允许的更大的图像，请使用--lowvram。
- 如果你有4GB的VRAM，在加载完整权重模型时出现内存不足错误，请使用--disable-model-loading-ram-optimization（在v1.6.0中添加）
Torch无法使用GPU
这是最常见的问题之一，但通常不是WebUI的问题，有很多原因导致这个问题。 - WebUI默认使用GPU，所以如果你没有合适的硬件，你需要在CPU上运行。 - 确保正确配置WebUI，请参考wiki中相应的安装教程。 - 如果在某些组件更新后遇到此问题，请尝试撤消最近的操作。
如果您是上述情况之一，您应该删除venv文件夹。
如果您仍然无法解决问题，在报告时需要提交一些额外的信息。
1. 在venv\Scripts下打开控制台
2. 运行python -m torch.utils.collect_env
3. 复制控制台的所有输出并发布
绿屏或黑屏
显卡
某些GPU显卡不支持半精度：生成的图片可能会出现绿屏或黑屏。使用--upcast-sampling。如果您正在使用--xformers，这应该与之配合使用。
如果仍然无法解决，请使用命令行参数--precision full --no-half，这会显著增加VRAM的使用量，可能需要--medvram。
在vae中产生了一个全为NaN的张量
这与上面的问题相同，为了验证，请使用--disable-nan-check。打开此选项后，如果其中一张图片失败，其余图片将会显示。
可能是模型原因 - 资源
可能是合并原因 - 资源
或者与GPU相关。
- NVIDIA 16XX和10XX系列的显卡应该使用--upcast-sampling和--xformers以达到相同的速度。如果问题仍然存在，请尝试通过添加--no-half-vae以fp32模式运行vae。如果这也失败了，您将不得不使用--no-half运行，这将是最慢的，并且使用最多的GPU内存。
- 无法正常运行fp16的AMD显卡应该使用
--upcast-sampling --opt-sub-quad-attention/--opt-split-attention-v1。回退顺序理想情况下应与上述相同。在此之后，如果仍然失败，AMD用户可能需要使用一些特殊技巧，例如"export HSA_OVERRIDE_GFX_VERSION=10.3.0"，具体取决于他们的GPU。最好进行彻底的谷歌搜索和所有github搜索，以找到适合您特定GPU的HSA_OVERRIDE_GFX_VERSION。
（这些是口口相传的故障排除技巧。使用fp32 4GB SD1模型进行测试）
启用xformers后出现"CUDA error: no kernel image is available for execution on the device"
您安装的xformers与您的GPU不兼容。如果您使用的是Python 3.10，拥有Pascal或更高版本的显卡，并在Windows上运行，请将--reinstall-xformers --xformers添加到您的COMMANDLINE_ARGS中以升级到可工作的版本。升级后删除--reinstall-xformers。
NameError: name 'xformers' is not defined
如果你使用的是Windows，这意味着你的Python版本太旧了。请使用3.10版本。
如果是Linux，你将需要自己构建xformers或避免使用xformers。
--share 在 gradio 3.22 更新后无效
Windows Defender/杀毒软件有时会阻止Gradio创建公共URL的能力。
- 打开你的杀毒软件
- 检查保护历史记录：\
- 将其添加为排除项
相关问题：
奇怪的CSS加载问题
这个问题已经被记录了3次。显然，中国的用户可能会遇到这个问题。 #8537