Kohya-ss/sd-scripts项目中Flux和SD3.5训练的分支选择指南

在kohya-ss/sd-scripts项目的开发过程中，针对不同训练需求存在多个代码分支。本文将为开发者明确Flux和SD3.5训练所需的分支选择方案。

分支架构说明

该项目目前维护着几个关键分支：

• main分支：稳定版本的基础代码
• dev分支：包含最新开发特性的实验性代码
• sd3分支：专门为FLUX.1和SD3.5训练优化的版本

训练环境选择建议

对于需要进行以下训练的用户：

1. FLUX.1训练：必须使用sd3分支
2. SD3.5模型训练：必须使用sd3分支

这两个训练场景之所以需要特定分支，是因为：

• 模型架构存在显著差异
• 需要特殊的训练参数处理
• 依赖特定的优化器实现

分支切换注意事项

当从main分支切换到sd3分支时，开发者需要注意：

1. 环境依赖可能发生变化，建议重建虚拟环境
2. 训练配置文件格式可能有细微差异
3. 部分辅助脚本的调用方式可能调整

版本兼容性说明

当前sd3分支与main分支的主要区别在于：

• 支持更新的模型架构
• 优化了大规模训练的稳定性
• 包含针对特定硬件（如最新GPU）的性能优化

建议开发者在开展新项目时直接基于sd3分支进行，而对于维护现有项目，则需要评估迁移成本。

最佳实践

1. 克隆仓库时指定分支：

git clone -b sd3 [仓库地址]

2. 已有仓库切换分支：

git fetch origin
git checkout sd3

3. 定期拉取更新：

git pull origin sd3

通过遵循这些指南，开发者可以确保获得最佳的模型训练体验和结果。