跳转至

SD WebUI All In One CLI

阅读导引

✨小巧,强大的命令工具

PyPI Release Python Lint Pytest PyPI Python Version

简介

SD WebUI All Ine One CLI 提供了一个强大的命令行界面,用于管理各种 AI 绘画软件的安装、更新、环境检查、启动以及模型和扩展管理。

安装

使用前需确保系统已安装 Python 3.10+ 和 Git

pip install sd-webui-all-in-one

安装完整依赖:

pip install "sd-webui-all-in-one[full]"

基础使用

可使用 --help 查看可用的命令。

sd-webui-all-in-one --help

自动镜像源选择

CLI 中涉及 PyPI、Github、HuggingFace 或模型下载源的子命令默认启用自动镜像源选择。执行命令时会调用 network_gfw_test() 判断当前网络是否需要镜像源:

  • 当检测结果为 True 时,CLI 会强制使用官方源:关闭 PyPI、Github、HuggingFace 镜像源,并将模型下载源设为 huggingface
  • 当检测结果为 False 时,CLI 会强制使用镜像源:启用 PyPI、Github、HuggingFace 镜像源,并将模型下载源设为 modelscope

Warning

自动镜像源选择会强制覆盖命令中已有的 --no-pypi-mirror--no-github-mirror--no-hf-mirror--custom-github-mirror--custom-hf-mirror--model-resource--source。如果需要手动调整这些镜像源设置,请显式添加 --no-auto-mirror

CLI 会在日志中提示是否启用了自动镜像源选择,以及最终使用官方源还是镜像源。

示例:

# 默认自动模式,手动镜像参数可能会被网络检测结果覆盖
sd-webui-all-in-one comfyui install --no-pypi-mirror --model-resource huggingface

# 禁用自动模式后,才会遵守手动镜像参数
sd-webui-all-in-one comfyui install --no-auto-mirror --no-pypi-mirror --model-resource huggingface