InvokeAI Installer 高级功能☍
高级功能☍
创建快捷启动方式☍
Info
该设置可通过 管理 InvokeAI Installer 设置 中提到的的 settings.ps1 进行修改。
在脚本同级目录创建 enable_shortcut.txt 文件，当运行 launch.ps1 时将会自动创建快捷启动方式，并添加到 Windows 桌面和 Windows 开始菜单中，下次启动时可以使用快捷方式启动 InvokeAI。
Warning
如果 InvokeAI 的路径发生移动，需要重新运行 launch.ps1 更新快捷启动方式。
使用命令运行 InvokeAI Installer☍
InvokeAI Installer 支持使用命令参数设置安装 InvokeAI 的参数，支持的参数如下。
| 参数 | 作用 |
|---|---|
-Help |
获取 InvokeAI Installer 的帮助信息。 |
-CorePrefix <内核路径前缀> |
设置内核的路径前缀，默认路径前缀为 core。 |
-InstallPath <安装 InvokeAI 的绝对路径> |
指定 InvokeAI Installer 安装 InvokeAI 的路径，使用绝对路径表示。 例如： ./invokeai_installer.ps1 -InstallPath "D:\Download"，这将指定安装到 D:\Download 路径。 |
-PyTorchMirrorType |
指定安装 PyTorch 时使用的镜像源类型。可指定的类型包括：cuda, rocm, xpu, mps, cpu |
-InstallPythonVersion |
指定要安装的 Python 版本。可选值：3.10, 3.11, 3.12, 3.13, 3.14 |
-UseUpdateMode |
指定 InvokeAI Installer 使用更新模式，只对 InvokeAI Installer 的管理脚本进行更新。 |
-DisablePyPIMirror |
禁用 InvokeAI Installer 使用 PyPI镜像源，使用 PyPI 官方源下载 Python 软件包。 |
-DisableProxy |
禁用 InvokeAI Installer 自动设置代理服务器。 |
-UseCustomProxy <代理服务器地址> |
使用自定义的代理服务器地址。例如：-UseCustomProxy "http://127.0.0.1:10809" |
-DisableUV |
禁用 InvokeAI Installer 使用 uv 安装 Python 软件包，改用 Pip 安装。 |
-DisableGithubMirror |
禁用 InvokeAI Installer 自动设置 Github 镜像源。 |
-UseCustomGithubMirror |
使用自定义的 Github 镜像站地址。可用的参考地址:https://ghfast.top/https://github.comhttps://mirror.ghproxy.com/https://github.comhttps://ghproxy.net/https://github.comhttps://gh-proxy.com/https://github.comhttps://kkgithub.com等。 |
-BuildMode |
启用构建模式，在基础安装结束后将调用管理脚本执行剩余任务。出现错误时不再暂停而是直接退出。 多个脚本将按以下优先级执行： reinstall_pytorch.ps1：对应-BuildWithTorch 参数download_models.ps1：对应-BuildWithModel 参数update.ps1：对应-BuildWithUpdate 参数update_node.ps1：对应-BuildWithUpdateNode 参数launch.ps1：对应-BuildWithLaunch 参数 |
-BuildWithTorch |
(需添加 -BuildMode) 调用 reinstall_pytorch.ps1 脚本，根据 PyTorch 类型安装指定的 PyTorch 版本。类型可运行该脚本查看。 |
-BuildWithModel <模型编号列表> |
(需添加 -BuildMode) 调用 download_models.ps1 脚本，根据编号列表下载模型。编号可运行该脚本查看。 |
-BuildWithUpdate |
(需添加 -BuildMode) 安装流程结束后调用 update.ps1 脚本，更新 InvokeAI 内核。 |
-BuildWithUpdateNode |
(需添加 -BuildMode) 安装流程结束后调用 update_node.ps1 脚本，更新 InvokeAI 扩展。 |
-BuildWithLaunch |
(需添加 -BuildMode) 安装流程结束后调用 launch.ps1 脚本，执行启动前的环境检查，但跳过启动 InvokeAI。 |
-NoPreDownloadModel |
安装 InvokeAI 时跳过预下载模型。 |
-NoCleanCache |
安装结束后保留下载的 Python 软件包缓存。 |
-DisableModelMirror |
不使用 ModelScope 下载模型, 使用 HuggingFace 下载模型。 |
-NoPause |
脚本执行完成后不暂停, 直接退出。 |
-DisableUpdate |
(仅在构建模式生效且只作用于管理脚本) 禁用 InvokeAI Installer 更新检查。 |
-DisableHuggingFaceMirror |
(仅在构建模式生效且只作用于管理脚本) 禁用 HuggingFace 镜像源。 |
-UseCustomHuggingFaceMirror |
(仅在构建模式生效且只作用于管理脚本) 使用自定义 HuggingFace 镜像源。例如：-UseCustomHuggingFaceMirror "https://hf-mirror.com" |
-LaunchArg |
(仅在构建模式生效且只作用于管理脚本) 设置 InvokeAI 自定义启动参数。如启用 --fast，则使用-LaunchArg "--fast"进行启用。 |
-EnableShortcut |
(仅在构建模式生效且只作用于管理脚本) 创建 InvokeAI 启动快捷方式。 |
-DisableCUDAMalloc |
(仅在构建模式生效且只作用于管理脚本) 禁用通过 PYTORCH_CUDA_ALLOC_CONF / PYTORCH_ALLOC_CONF 环境变量设置 CUDA 内存分配器。 |
-DisableEnvCheck |
(仅在构建模式生效且只作用于管理脚本) 禁用检查 InvokeAI 运行环境问题。 |
例如在 D:/Download 这个路径安装 InvokeAI，则在 InvokeAI Installer 所在路径打开 PowerShell，使用参数运行 InvokeAI Installer。
InvokeAI Installer 构建模式和普通安装模式☍
InvokeAI Installer 主要由两部分构成：安装脚本和环境管理脚本。
在 InvokeAI Installer 默认的普通安装模式下，只执行最基础的安装流程，而像其他的流程，如 PyTorch 版本更换，模型安装，运行环境检查和修复等并不会执行，这些步骤是在 InvokeAI Installer 管理脚本中进行，如执行 launch.ps1,reinstall_pytorch.ps1 脚本等。
而 InvokeAI Installer 构建模式允许在执行基础安装流程后，调用 InvokeAI Installer 管理脚本完成这些步骤。基于这个特性，启用构建模式的 InvokeAI Installer 可用于整合包制作，搭配自动化平台可实现全自动制作整合包。
构建模式需要使用命令行参数进行启用，具体可阅读 使用命令运行 InvokeAI Installer 中的参数说明。
Info
通常安装 InvokeAI 并不需要使用 InvokeAI Installer 构建模式进行安装，使用默认的普通安装模式即可。构建模式多用于自动化制作整合包。
使用 Github Action 提供的容器可用于运行 InvokeAI Installer 并启用构建模式，实现自动化制作整合包，Github Action 工作流代码可参考：build_invokeai.yml · licyk/sd-webui-all-in-one