SubjectSpatial200K
收藏UniCombine 数据集概述
数据集名称
UniCombine
数据集描述
UniCombine 是一个统一的多条件组合框架,通过扩散变换器(Diffusion Transformer)实现多条件可控生成。该框架能够有效处理任何输入条件的组合,并与所有条件(包括但不限于文本提示、空间地图和主体图像)实现显著对齐。
关键特性
- 支持多条件可控生成任务,包括主体插入、主体空间、多空间等任务。
- 主体空间200K(SubjectSpatial200K)数据集的发布,用于训练和测试。
更新日志
- 2025年3月12日:发布 SubjectSpatial200K 数据集。
- 2025年3月12日:发布 UniCombine 框架。
依赖和安装
使用以下命令创建和激活 Python 环境,并安装依赖: bash conda create -n unicombine python=3.12 conda activate unicombine pip install -r requirements.txt
模型下载
将所有模型权重放置在 ckpt 目录中。以下是下载不同模型的命令:
bash
huggingface-cli download black-forest-labs/FLUX.1-schnell --local-dir ./ckpt/FLUX.1-schnell
huggingface-cli download Xuan-World/UniCombine --include "Condition_LoRA/" --local-dir ./ckpt/Condition_LoRA
huggingface-cli download Xuan-World/UniCombine --include "Denoising_LoRA/" --local-dir ./ckpt/Denoising_LoRA
数据集下载(可选)
以下命令用于下载和分区 SubjectSpatial200K 数据集: bash huggingface-cli download Xuan-World/SubjectSpatial200K --repo-type dataset --local-dir ./dataset python src/partition_dataset.py --dataset dataset/SubjectSpatial200K/data_labeled --output_dir dataset/split_SubjectSpatial200K --partition train python src/partition_dataset.py --dataset dataset/SubjectSpatial200K/Collection3/data_labeled --output_dir dataset/split_SubjectSpatial200K/Collection3 --partition train python src/partition_dataset.py --dataset dataset/SubjectSpatial200K/data_labeled --output_dir dataset/split_SubjectSpatial200K --partition test python src/partition_dataset.py --dataset dataset/SubjectSpatial200K/Collection3/data_labeled --output_dir dataset/split_SubjectSpatial200K/Collection3 --partition test
训练
- 单条件设置下的训练:参考 https://github.com/Yuanshi9815/OminiControl 训练 Condition-LoRA 模块。
- 多条件设置下的训练:使用 SubjectSpatial200K 数据集或自定义的多条件数据集训练 Denoising-LoRA 模块。
推断
提供 inference.py 脚本以在示例数据上运行推断。支持基于训练和无需训练的版本。
引用
请根据数据集使用情况引用相关论文或资源。




