跳转至

Fooocus Installer 高级功能☍

高级功能☍

使用绘世启动器☍

Info

推荐使用自动安装绘世启动器的方法，可以参考 命令的使用 中的 安装绘世启动器并自动配置绘世启动器所需的环境 命令，该命令可一键配置下载绘世启动器并配置，并且生成 hanamizuki.bat 脚本用于快捷启动绘世启动器，或者可以尝试下面手动配置绘世启动器的方法。

Fooocus Installer 部署出来的 Fooocus 可以通过绘世启动器进行启动，使用绘世启动器前需要调整目录结构使绘世启动器能够正确识别到环境。

将 Fooocus/python 目录移动到 Fooocus/Fooocus/python,Fooocus/git 移动到Fooocus/Fooocus/git。

Note

实际路径需要根据内核路径前缀来决定，如果内核路径前缀为 core，则实际移动到的路径分别为 Fooocus/core/python 和Fooocus/core/git。建议通过自动安装绘世启动器的方法来安装绘世启动器。

移动前目录的结构如下。

.
├── Fooocus
│   ├── activate.ps1
│   ├── cache
│   ├── download_models.ps1
│   ├── launch_fooocus_installer.ps1
│   ├── git                           # Git 目录
│   ├── help.txt
│   ├── launch.ps1
│   ├── Fooocus                       # Fooocus 路径
│   │   ├── ...
│   │   └── main.py
│   ├── python                        # Python 目录
│   ├── reinstall_pytorch.ps1
│   ├── switch_branch.ps1
│   ├── settings.ps1
│   ├── terminal.ps1
│   ├── update_extension.ps1
│   └── update.ps1
└── fooocus_installer.ps1

移动 Python 和 Git 之后的目录结构。

.
├── Fooocus
│   ├── activate.ps1
│   ├── cache
│   ├── download_models.ps1
│   ├── launch_fooocus_installer.ps1
│   ├── help.txt
│   ├── launch.ps1
│   ├── Fooocus        # Fooocus 路径
│   │   ├── git                       # Git 目录
│   │   ├── python                    # Python 目录
│   │   ├── ...
│   │   └── main.py
│   ├── reinstall_pytorch.ps1
│   ├── switch_branch.ps1
│   ├── settings.ps1
│   ├── terminal.ps1
│   ├── update_extension.ps1
│   └── update.ps1
└── fooocus_installer.ps1

再下载绘世启动器放到 Fooocus/Fooocus 目录中，就可以通过启动器启动 Fooocus。

绘世启动器下载
下载地址 1
下载地址 2
下载地址 3
下载地址 4

创建快捷启动方式☍

Info

该设置可通过 管理 Fooocus Installer 设置 中提到的的 settings.ps1 进行修改。

在脚本同级目录创建 enable_shortcut.txt 文件，当运行 launch.ps1 时将会自动创建快捷启动方式，并添加到 Windows 桌面和 Windows 开始菜单中，下次启动时可以使用快捷方式启动 Fooocus。

Warning

如果 Fooocus 的路径发生移动，需要重新运行 launch.ps1 更新快捷启动方式。

使用命令运行 Fooocus Installer☍

Fooocus Installer 支持使用命令参数设置安装 Fooocus 的参数，支持的参数如下。

参数 作用
-Help 获取 Fooocus Installer 的帮助信息。
-CorePrefix <内核路径前缀> 设置内核的路径前缀，默认路径前缀为 core。
-InstallPath <安装 Fooocus 的绝对路径> 指定 Fooocus Installer 安装 Fooocus 的路径，使用绝对路径表示。
例如：./fooocus_installer.ps1 -InstallPath "D:\Download"，这将指定安装到 D:\Download 路径。
-PyTorchMirrorType 指定安装 PyTorch 时使用的镜像源类型。可指定的类型包括：cu113, cu117, cu118, cu121, cu124, cu126, cu128, cu129, cu130, rocm5.4.2, rocm5.6, rocm5.7, rocm6.0, rocm6.1, rocm6.2, rocm6.2.4, rocm6.3, rocm6.4, rocm7.1, rocm_rdna3, rocm_rdna3.5, rocm_rdna4, rocm_win, xpu, ipex_legacy_arc, cpu, directml, all
-InstallPythonVersion 指定要安装的 Python 版本。可选值：3.10, 3.11, 3.12, 3.13, 3.14
-InstallBranch <安装的 Fooocus 分支> 指定安装的 Fooocus 分支。未指定时默认安装 fooocus_main。
支持的分支如下：
  • fooocus_main: lllyasviel - Fooocus 分支
  • ruined_fooocus_main: runew0lf - RuinedFooocus 分支
  • fooocus_mre_main: MoonRide303 - Fooocus-MRE 分支
    		•
    -UseUpdateMode 指定 Fooocus Installer 使用更新模式，只对 Fooocus Installer 的管理脚本进行更新。
    -DisablePyPIMirror 禁用 Fooocus Installer 使用 PyPI镜像源，使用 PyPI 官方源下载 Python 软件包。
    -DisableProxy 禁用 Fooocus Installer 自动设置代理服务器。
    -UseCustomProxy <代理服务器地址> 使用自定义的代理服务器地址。例如：-UseCustomProxy "http://127.0.0.1:10809"
    -DisableUV 禁用 Fooocus Installer 使用 uv 安装 Python 软件包，改用 Pip 安装。
    -DisableGithubMirror 禁用 Fooocus Installer 自动设置 Github 镜像源。
    -UseCustomGithubMirror 使用自定义的 Github 镜像站地址。
    可用的参考地址:
    https://ghfast.top/https://github.com
    https://mirror.ghproxy.com/https://github.com
    https://ghproxy.net/https://github.com
    https://gh-proxy.com/https://github.com
    https://kkgithub.com等。
    -BuildMode 启用构建模式，在基础安装结束后将调用管理脚本执行剩余任务。出现错误时不再暂停而是直接退出。
    多个脚本将按以下优先级执行：
  • reinstall_pytorch.ps1：对应-BuildWithTorch/-BuildWithTorchReinstall
  • download_models.ps1：对应-BuildWithModel
  • switch_branch.ps1：对应-BuildWithBranch
  • update.ps1：对应-BuildWithUpdate
  • launch.ps1：对应-BuildWithLaunch
    		•
    -BuildWithTorch (需添加 -BuildMode) 调用 reinstall_pytorch.ps1 脚本，根据版本编号安装指定的 PyTorch 版本。编号可运行该脚本查看。
    -BuildWithTorchReinstall (需添加 -BuildMode及-BuildWithTorch) 执行 PyTorch 指定版本安装时使用强制重新安装模式。
    -BuildWithModel <模型编号列表> (需添加 -BuildMode) 调用 download_models.ps1 脚本，根据编号列表下载模型。编号可运行该脚本查看。
    -BuildWithBranch (需添加 -BuildMode) 调用 switch_branch.ps1 脚本，根据分支编号切换分支。编号可运行该脚本查看。
    -BuildWithUpdate (需添加 -BuildMode) 安装流程结束后调用 update.ps1 脚本，更新 Fooocus 内核。
    -BuildWithLaunch (需添加 -BuildMode) 安装流程结束后调用 launch.ps1 脚本，执行启动前的环境检查，但跳过启动 Fooocus。
    -NoPreDownloadModel 安装 Fooocus 时跳过预下载模型。
    -PyTorchPackage (需搭配 -xFormersPackage) 指定安装的 PyTorch 版本。如：-PyTorchPackage "torch==2.3.0+cu118 torchvision==0.18.0+cu118 torchaudio==2.3.0+cu118"
    -xFormersPackage (需搭配 -PyTorchPackage) 指定安装的 xFormers 版本。如：-xFormersPackage "xformers===0.0.26.post1+cu118"
    -InstallHanamizuki 安装绘世启动器，并生成 hanamizuki.bat 用于启动。
    -NoCleanCache 安装结束后保留下载的 Python 软件包缓存。
    -DisableModelMirror 不使用 ModelScope 下载模型, 使用 HuggingFace 下载模型。
    -NoPause 脚本执行完成后不暂停, 直接退出。
    -DisableUpdate (仅在构建模式生效且只作用于管理脚本) 禁用 Fooocus Installer 更新检查。
    -DisableHuggingFaceMirror (仅在构建模式生效且只作用于管理脚本) 禁用 HuggingFace 镜像源。
    -UseCustomHuggingFaceMirror (仅在构建模式生效且只作用于管理脚本) 使用自定义 HuggingFace 镜像源。例如：-UseCustomHuggingFaceMirror "https://hf-mirror.com"
    -LaunchArg (仅在构建模式生效且只作用于管理脚本) 设置 Fooocus 自定义启动参数。如：-LaunchArg "--fast --auto-launch"
    -EnableShortcut (仅在构建模式生效且只作用于管理脚本) 创建 Fooocus 启动快捷方式。

    例如在 D:/Download 这个路径安装 MoonRide303/Fooocus-MRE，则在 Fooocus Installer 所在路径打开 PowerShell，使用参数运行 Fooocus Installer。

    ./fooocus_installer.ps1 -InstallPath "D:/Download" -InstallBranch "fooocus_mre_main"

    Fooocus Installer 构建模式和普通安装模式☍

    Fooocus Installer 主要由两部分构成：安装脚本和环境管理脚本。

    在 Fooocus Installer 默认的普通安装模式下，只执行最基础的安装流程，而像其他的流程，如 PyTorch 版本更换，模型安装，运行环境检查和修复等并不会执行，这些步骤是在 Fooocus Installer 管理脚本中进行，如执行 launch.ps1,reinstall_pytorch.ps1 脚本等。

    而 Fooocus Installer 构建模式允许在执行基础安装流程后，调用 Fooocus Installer 管理脚本完成这些步骤。基于这个特性，启用构建模式的 Fooocus Installer 可用于整合包制作，搭配自动化平台可实现全自动制作整合包。

    构建模式需要使用命令行参数进行启用，具体可阅读 使用命令运行 Fooocus Installer 中的参数说明。

    Info

    通常安装 Fooocus 并不需要使用 Fooocus Installer 构建模式进行安装，使用默认的普通安装模式即可。构建模式多用于自动化制作整合包。

    使用 Github Action 提供的容器可用于运行 Fooocus Installer 并启用构建模式，实现自动化制作整合包，Github Action 工作流代码可参考：build_fooocus.yml · licyk/sd-webui-all-in-one