CoolFace
Modelpublic

ATH-MaaS/CHATS

sourceHugging Faceapache-2.0updated 1y agoView on Hugging Face
7likes12downloads
Model Card

CHATS: Combining Human-Aligned Optimization and Test-Time Sampling for Text-to-Image Generation (ICML2025)

<p align="center"> πŸ“ <a href="https://arxiv.org/abs/2502.12579" target="blank">Paper</a> β€’ πŸ’‘ <a href="https://zhuanlan.zhihu.com/p/1904156278621737628" target="blank">ηŸ₯乎</a> β€’ πŸ’» <a href="https://github.com/AIDC-AI/CHATS" target="_blank">Github</a> </p>

CHATS is a next-generation framework that unifies human preference alignment with classifier-free guidance by modeling both preferred and dispreferred distributions and using a proxy-prompt-based sampling strategy for superior text–image alignment, fidelity, and aesthetic consistency. See the images generated below for examples.

<figure> <img src="qualitative_imgs.jpg" alt="CHATS results"> <figcaption style="text-align: center;">Generation examples using CHATS (cf. Fig.1 in our paper).</figcaption> </figure>


πŸš€ Key Features

  • β€”Human-Aligned Fine-Tuning with CFG Integration We integrate human preference alignment with classifier-free guidance sampling into a unified framework.
  • β€”Proxy-Prompt Sampling Leverage useful signals from both preferred and dispreferred distributions at test time.
  • β€”Data Efficiency State-of-the-art results across benchmarks with minimal fine-tuning effort on a small, high-quality dataset.
  • β€”Plug-and-Play Compatible with any diffusion backbone and existing guidance methods.

πŸ“¦ Installation

bash
git clone https://github.com/AIDC-AI/CHATS.git
cd CHATS
pip install -r requirements.txt

πŸ“‚ Model Checkpoints

We provide pretrained CHATS checkpoints on SDXL for easy download and evaluation:

  • β€”Model Repository: ![Hugging Face](https://huggingface.co/AIDC-AI/CHATS)

πŸ› οΈ Quick Start

python
import torch
from pipeline import ChatsSDXLPipeline

# Load CHATS-SDXL pipeline
pipe = ChatsSDXLPipeline.from_pretrained(
        "AIDC-AI/CHATS",
        torch_dtype=torch.bfloat16
)
pipe.to("cuda")

# Generate images
images = pipe(
    prompt=["A serene mountain lake at sunset"],
    num_inference_steps=50,
    guidance_scale=5,
    seed=0
)

# Save outputs
for i, img in enumerate(images):
    img.save(f"output_{i}.png")

πŸ‹οΈ Training

To train CHATS from scratch or fine-tune on your own data, run:

bash
accelerate launch --config_file=config/ac_ds_8gpu_zero0.yaml  train.py \
        --pretrained_model_name_or_path=stabilityai/stable-diffusion-xl-base-1.0 \
        --pretrained_vae_model_name_or_path=madebyollin/sdxl-vae-fp16-fix \
        --resolution=1024 \
        --dataloader_num_workers 16 \
        --train_batch_size=1 \
        --gradient_accumulation_steps=16 \
        --max_train_steps=6000 \
        --learning_rate=3e-09 --scale_lr --lr_scheduler=constant_with_warmup --lr_warmup_steps=100 \
        --mixed_precision=bf16 \
        --allow_tf32 \
        --checkpointing_steps=100 \
        --output_dir=output \
        --resume_from_checkpoint latest \
        --use_adafactor \
        --gradient_checkpointing \
        --dataset_name=data-is-better-together/open-image-preferences-v1-binarized \

Args:

  • β€”configfile: This DeepSpeed parameter allows you to specify the configuration file. If you wish to adjust the number of GPUs used for training, simply change the value of **numprocesses** in the acdsxgpu_zero0.yaml file to reflect the desired GPU count.
  • β€”pretrainedmodelnameorpath: name or patch of unet model to load
  • β€”pretrainedvaemodelnameor_path: name or patch of vae model to load
  • β€”maxtrainsteps: max steps to train
  • β€”output: output dir
  • β€”dataset_name: the huggingface sufix of the selected dataset (e.g. OIP)

πŸ“š Citation

If you use CHATS, please cite our ICML 2025 paper:

bibtex
@inproceedings{fu2025chats,
title={CHATS: Combining Human-Aligned Optimization and Test-Time Sampling for Text-to-Image Generation},
author={Fu, Minghao and Wang, Guo-Hua and Cao, Liangfu and Chen, Qing-Guo and Xu, Zhao and Luo, Weihua and Zhang, Kaifu},
booktitle={International Conference on Machine Learning (ICML)},
year={2025}
}

πŸ™ Acknowledgments

The code is built upon DiffusionDPO, Diffusers, and Transformers.

πŸ“„ License

The project is released under Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0, SPDX-License-identifier: Apache-2.0).

🚨 Disclaimer

We used compliance checking algorithms during the training process, to ensure the compliance of the trained model to the best of our ability. Due to complex data and the diversity of language model usage scenarios, we cannot guarantee that the model is completely free of copyright issues or improper content. If you believe anything infringes on your rights or generates improper content, please contact us, and we will promptly address the matter.