跳转至

CLI - InvokeAI☍

InvokeAI☍

InvokeAI 是一款功能强大的 Stable Diffusion 创意引擎。

Note

本页中包含镜像源设置的子命令默认启用自动镜像源选择，并支持 --no-auto-mirror。自动模式会根据网络检测结果强制覆盖 PyPI、Github、HuggingFace 和模型下载源参数；需要手动调整 --no-*mirror、--custom-*、--model-resource 或 --source 时，请同时添加 --no-auto-mirror。

安装 InvokeAI☍

sd-webui-all-in-one invokeai install [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录，默认为配置文件中的路径。
  • --device-type <类型>: 设备类型 (cuda, rocm, cpu, mps)。
  • --version <版本>: 自定义安装版本。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。
  • --no-uv: 不使用 uv 安装 Python 软件包。
  • --no-pre-download-model: 禁用预下载模型。
  • --model-resource: 模型下载源类型 (默认: modelscope)。

更新 InvokeAI☍

sd-webui-all-in-one invokeai update [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。
  • --no-uv: 不使用 uv 安装 Python 软件包。
  • --no-snapshot: 禁用操作前自动创建环境快照。
  • --snapshot-dir <路径>: 操作前自动快照目录；未传时使用默认快照目录。

生成环境快照☍

sd-webui-all-in-one invokeai snapshot [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --output <路径>: 输出目录路径；未传时保存到默认快照目录并自动生成带时间戳的文件名。
  • --no-packages: 不记录当前 Python 环境已安装软件包。

恢复环境快照☍

sd-webui-all-in-one invokeai restore <快照文件> [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --prune-packages: 卸载快照外 Python 软件包，受保护的管理器和基础安装工具不会卸载。
  • --prune-extensions: 删除快照外扩展。
  • --force-git-reset: 允许覆盖 Git 仓库未提交变更。
  • --no-uv: 不使用 uv 安装 Python 软件包。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。
  • --no-github-mirror: 不使用 Github 镜像源。
  • --custom-github-mirror <URL>: 自定义 Github 镜像源。

检查运行环境☍

sd-webui-all-in-one invokeai check-env [选项]
  • 高级选项:
  • --no-uv: 不使用 uv。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。

启动 InvokeAI☍

sd-webui-all-in-one invokeai launch [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --launch-args <参数>: 启动参数 (请使用引号包裹，例如 "--theme dark")。
  • --no-hf-mirror: 禁用 HuggingFace 镜像源。
  • --custom-hf-mirror <URL>: 自定义 HuggingFace 镜像源。
  • --no-pypi-mirror: 禁用 PyPI 镜像源。
  • --no-cuda-malloc: 禁用 CUDA Malloc 优化。
  • --no-uv: 不使用 uv。
  • --no-check-env: 不检查运行环境完整性。
  • --no-hotpatcher: 禁用 Hotpatcher 补丁系统注入，默认启用。
  • --hotpatcher-runtime: 启用 Hotpatcher runtime host 连接，默认只做本地补丁注入。
  • --hotpatcher-config <路径>: Hotpatcher 配置文件路径。未指定时使用默认配置路径或内置默认配置。
  • --hotpatcher-port <端口>: Hotpatcher runtime 通信端口，仅在 --hotpatcher-runtime 启用时生效。

版本管理 GUI☍

sd-webui-all-in-one invokeai gui version-manager [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --no-pypi-mirror: 不使用 PyPI 镜像源。
  • --no-uv: 不使用 uv 安装 Python 软件包。
  • --no-github-mirror: 不使用 Github 镜像源。
  • --custom-github-mirror <URL>: 自定义 Github 镜像源。
  • --no-snapshot: 禁用启动前自动创建环境快照。
  • --snapshot-dir <路径>: 启动前自动快照目录；未传时使用默认快照目录。

快照管理 GUI☍

sd-webui-all-in-one invokeai gui snapshot-manager [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --snapshot-dir <路径>: 快照目录。
  • --no-uv: 不使用 uv 安装 Python 软件包。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。
  • --no-github-mirror: 不使用 Github 镜像源。
  • --custom-github-mirror <URL>: 自定义 Github 镜像源。

模型管理 GUI☍

sd-webui-all-in-one invokeai gui model-manager [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。

InvokeAI 模型管理 GUI 使用 InvokeAI 自身的模型管理服务，不按普通文件夹直接移动模型。URL 安装会交给 InvokeAI 解析和下载；本地导入会先复制源文件，再注册复制后的模型，原文件会保留在原位置。删除/注销操作会调用 InvokeAI 删除接口：位于 InvokeAI 管理目录内的模型文件会被同步删除，就地安装的外部模型文件只会保留并注销记录。

扩展管理 (Custom Node)☍

安装扩展☍

sd-webui-all-in-one invokeai custom-node install --url <链接> [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --url <链接>: (必填) 扩展下载链接。
  • --no-github-mirror: 不使用 Github 镜像源。
  • --custom-github-mirror <URL>: 自定义 Github 镜像源。

设置扩展状态☍

sd-webui-all-in-one invokeai custom-node status --name <名称> [--enable|--disable] [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --name <名称>: (必填) 扩展名称。
  • --enable: 启用扩展。
  • --disable: 禁用扩展。

列出扩展☍

sd-webui-all-in-one invokeai custom-node list [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。

更新扩展☍

sd-webui-all-in-one invokeai custom-node update [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --no-github-mirror: 不使用 Github 镜像源。
  • --custom-github-mirror <URL>: 自定义 Github 镜像源。
  • --no-snapshot: 禁用操作前自动创建环境快照。
  • --snapshot-dir <路径>: 操作前自动快照目录；未传时使用默认快照目录。

卸载扩展☍

sd-webui-all-in-one invokeai custom-node uninstall --name <名称> [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --name <名称>: (必填) 扩展名称。

模型管理☍

从模型库安装模型☍

sd-webui-all-in-one invokeai model install-library [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --source <源>: 模型下载源类型 (默认: modelscope)。
  • --name <名称>: 模型名称。
  • --index <索引>: 模型索引。
  • --downloader <工具>: 下载工具 (默认: requests)。
  • --interactive: 启用交互模式。
  • --list-only: 列出模型列表并退出。

从链接安装模型☍

sd-webui-all-in-one invokeai model install-url --url <链接> --type <类型> [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --url <链接>: (必填) 模型下载地址。
  • --type <类型>: (必填) 模型类型。
  • --downloader <工具>: 下载工具 (默认: requests)。

列出模型☍

sd-webui-all-in-one invokeai model list

卸载模型☍

sd-webui-all-in-one invokeai model uninstall --name <名称> [选项]
  • 高级选项:
  • --name <名称>: (必填) 模型名称。
  • --interactive: 启用交互模式。

重装 PyTorch☍

sd-webui-all-in-one invokeai reinstall-pytorch [选项]
  • 高级选项:
  • --invokeai-path <路径>: InvokeAI 根目录。
  • --device-type <类型>: 设备类型 (cuda, rocm, cpu, mps)。
  • --no-pypi-mirror: 不使用国内 PyPI 镜像源。
  • --no-uv: 不使用 uv 安装 PyTorch 软件包。
  • --interactive: 启用交互模式。
  • --list-only: 列出 PyTorch 列表并退出。
  • --no-snapshot: 禁用操作前自动创建环境快照。
  • --snapshot-dir <路径>: 操作前自动快照目录；未传时使用默认快照目录。