Hanafubuki

WebUI 安装方式

根据现有文件、Python 环境和快照情况选择正确的实例来源。

在 Hanafubuki 中,一个“实例”由实例记录、实例根目录、独立 Python 和 WebUI Core 组成。首页点击“添加实例”后,可以选择四种来源;它们对现有文件的处理方式不同。

安装前检查

开始前建议确认:

  • 首次启动的 Python、Micromamba 和 Git 已准备完成;异常时先打开“设置 → 运行环境”。
  • 网络能够访问需要的代码仓库和软件包来源,或已经配置可用的网络与代理和镜像。
  • 目标磁盘有足够空间,并允许当前用户创建、修改和删除文件。
  • 模型、输出和自定义代码已有独立备份;环境快照不包含这些文件的完整副本。

选择实例来源

来源适合什么情况是否安装环境对现有文件的影响
全新安装没有现成 WebUI,希望从头创建下载独立 Python、Core 和依赖应使用新的专用实例目录
导入现有实例已知现有根目录、Core 和独立 Python不重新安装,导入后直接就绪只引用原路径;后续管理操作可能修改这些文件
扫描系统不确定 WebUI 位于哪里,或只有 Core完整实例直接就绪;缺少 Python 的实例等待安装扫描阶段只读取;后续补装可能修改发现的 Core
从快照恢复已有环境快照 JSON,希望重建环境按快照准备 Python、代码、包和扩展会清理目标环境并强制重置目标 Git 仓库

最简单的选择

第一次使用请选择“全新安装”并保留默认选项。已有能运行的独立 Python 和 WebUI 时选择“导入现有实例”;只有代码目录或不确定目录结构时使用“扫描系统”。

支持的 WebUI

类型主要用途来源
Stable Diffusion WebUI基于 Gradio 的图像生成界面10 个变体
ComfyUI节点式生成工作流Comfy-Org/ComfyUI
InvokeAI带统一画布的图像创作工具PyPI 软件包 invokeai
Fooocus简化的图像生成流程3 个变体
SD TrainerLoRA 与模型训练3 个变体
Qwen TTS WebUI文本转语音licyk/qwen-tts-webui
RVC Next WebUI语音转换与实时变声licyk/rvc-next-webui
Mizuoto TTS WebUI多引擎文本转语音licyk/mizuoto-tts-webui

选择的类型决定安装器、默认 Python、PyTorch 选项以及安装后可用的管理功能。不要只按目录名称猜测类型。

支持的变体

Stable Diffusion WebUI、Fooocus 和 SD Trainer 各自提供一组变体:每个变体是一组固定的仓库、分支和子模块设置。全新安装时在“分支”中选择变体,安装后可在WebUI 变体页面切换。ComfyUI、Qwen TTS WebUI 和 RVC Next WebUI 只使用上表中的单一仓库;InvokeAI 以软件包形式安装,版本在WebUI 版本页面管理。

下表对应本版本 Hanafubuki 内置的 sd-webui-all-in-one。应用更新后列表可能变化,以安装向导和变体页面实际显示的内容为准。

Stable Diffusion WebUI 变体

变体仓库分支子模块
Stable-Diffusion-WebUI-Forge-Neo(默认)Haoming02/sd-webui-forge-classicneo—
Stable-Diffusion-WebUI-Forge-ClassicHaoming02/sd-webui-forge-classicclassic—
Stable-Diffusion-WebUI 主分支AUTOMATIC1111/stable-diffusion-webuimaster—
Stable-Diffusion-WebUI 测试分支AUTOMATIC1111/stable-diffusion-webuidev—
Stable-Diffusion-WebUI-Forgelllyasviel/stable-diffusion-webui-forgemain—
Stable-Diffusion-WebUI-reForge 主分支Panchovix/stable-diffusion-webui-reForgemain—
Stable-Diffusion-WebUI-reForge 测试分支Panchovix/stable-diffusion-webui-reForgedev—
Stable-Diffusion-WebUI-AMDGPUlshqqytiger/stable-diffusion-webui-amdgpumaster—
SD.Next 主分支vladmandic/sdnextmaster包含
SD.Next 测试分支vladmandic/sdnextdev包含

安装向导中的“默认分支”即 Forge-Neo。测试分支更新频繁,可能与扩展或模型工作流不兼容;AMDGPU 变体面向 AMD 显卡。

Fooocus 变体

变体仓库分支子模块
Fooocuslicyk/Fooocuslicyk_dev—
RuinedFooocusrunew0lf/RuinedFooocusmain—
Fooocus-MREMoonRide303/Fooocus-MREmoonride-main—

“Fooocus”变体基于 lllyasviel 的原版 Fooocus,但使用 licyk 维护的分叉仓库。

SD Trainer 变体

变体仓库分支子模块
SD-TrainerAkegarasu/lora-scriptsmain包含
SD Trainer Nextwochenlong/lora-scripts-nextmain包含
Kohya GUIbmaltais/kohya_ssmaster包含

本页目录