StyleShot

open-mmlabMIT长期未更新

无需微调即可把任意参考图的风格迁移到任意内容上,生成高质量个性化风格化图片的风格迁移模型。

StyleShot: A SnapShot on Any Style. 一款可以迁移任意风格到任意内容的模型,无需针对图片微调,即能生成高质量的个性风格化图片!

暂无版本474star41fork同步于 2026-11-07 07:30 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/open-mmlab/StyleShot.git
cd StyleShot
conda create -n styleshot python==3.8
conda activate styleshot
pip install -r requirements.txt
硬件要求按 README 说明

README 未说明显存要求与支持的 GPU 型号;训练示例使用 8 卡多进程 accelerate 启动,推理未给出硬件说明。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

无需微调即可把任意参考图风格迁移到内容上的风格化生成模型

无需微调即可把任意参考图的风格迁移到任意内容上,生成高质量个性化风格化图片的风格迁移模型。

核心能力

  • 用风格感知编码器提取解耦的风格表示
  • 支持文本驱动、图像驱动两种风格迁移推理
  • 可结合 ControlNet 与 T2I-Adapter 做条件控制
  • 提供线稿控制版本 StyleShot_lineart
  • 附带 StyleGallery 训练集与 StyleBench 评测基准

容易踩的坑

除主权重外还需另行下载 stable-diffusion-v1-5、T2I-Adapter、ControlNet 和 CLIP 模型;权重需用 git lfs 拉取;环境固定为 Python 3.8。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    StyleShot: A SnapShot on Any Style

                           

    Junyao Gao, Yanchen Liu, Yanan Sun‡, Yinhao Tang, Yanhong Zeng, Kai Chen*, Cairong Zhao* (* corresponding authors, ‡ project leader)

    From Tongji University and Shanghai AI lab.

    Abstract

    In this paper, we show that, a good style representation is crucial and sufficient for generalized style transfer without test-time tuning. We achieve this through constructing a style-aware encoder and a well-organized style dataset called StyleGallery. With dedicated design for style learning, this style-aware encoder is trained to extract expressive style representation with decoupling training strategy, and StyleGallery enables the generalization ability. We further employ a content-fusion encoder to enhance image-driven style transfer. We highlight that, our approach, named StyleShot, is simple yet effective in mimicking various desired styles, i.e., 3D, flat, abstract or even fine-grained styles, without test-time tuning. Rigorous experiments validate that, StyleShot achieves superior performance across a wide range of styles compared to existing state-of-the-art methods. arch

    News

    • [2024/8/29] 🔥 Thanks to @neverbiasu's contribution. StyleShot is now available on ComfyUI.
    • [2024/7/5] 🔥 We release online demo in HuggingFace.
    • [2024/7/3] 🔥 We release StyleShot_lineart, a version taking the lineart of content image as control.
    • [2024/7/2] 🔥 We release the paper.
    • [2024/7/1] 🔥 We release the code, checkpoint, project page and online demo.

    Start

    # install styleshot
    git clone https://github.com/open-mmlab/StyleShot.git
    cd StyleShot
    
    # create conda env
    conda create -n styleshot python==3.8
    conda activate styleshot
    pip install -r requirements.txt
    
    # download the models
    git lfs install
    git clone https://huggingface.co/Gaojunyao/StyleShot
    git clone https://huggingface.co/Gaojunyao/StyleShot_lineart
    

    Models

    you can download our pretrained weight from here. To run the demo, you should also download the following models:

    Inference

    For inference, you should download the pretrained weight and prepare your own reference style image or content image.

    # run text-driven style transfer demo
    python styleshot_text_driven_demo.py --style "{style_image_path}" --prompt "{prompt}" --output "{save_path}"
    
    # run image-driven style transfer demo
    python styleshot_image_driven_demo.py --style "{style_image_path}"  --content "{content_image_path}" --preprocessor "Contour" --prompt "{prompt}" --output "{save_path}"
    
    # integrate styleshot with controlnet and t2i-adapter
    python styleshot_t2i-adapter_demo.py --style "{style_image_path}"  --condition "{condtion_image_path}" --prompt "{prompt}" --output "{save_path}"
    python styleshot_controlnet_demo.py --style "{style_image_path}"  --condition "{condtion_image_path}" --prompt "{prompt}" --output "{save_path}"
    

    Train

    We employ a two-stage training strategy to train our StyleShot for better integration of content and style. For training data, you can use our training dataset StyleGallery or make your own dataset into a json file.

    # training stage-1, only training the style component.
    accelerate launch --num_processes 8 --multi_gpu --mixed_precision "fp16" \
      tutorial_train_styleshot_stage_1.py \
      --pretrained_model_name_or_path="runwayml/stable-diffusion-v1-5/" \
      --image_encoder_path="{image_encoder_path}" \
      --image_json_file="{data.json}" \
      --image_root_path="{image_path}" \
      --mixed_precision="fp16" \
      --resolution=512 \
      --train_batch_size=16 \
      --dataloader_num_workers=4 \
      --learning_rate=1e-04 \
      --weight_decay=0.01 \
      --output_dir="{output_dir}" \
      --save_steps=10000
    
    # training stage-2, only training the content component.
    accelerate launch --num_processes 8 --multi_gpu --mixed_precision "fp16" \
      tutorial_train_styleshot_stage_2.py \
      --pretrained_model_name_or_path="runwayml/stable-diffusion-v1-5/" \
      --pretrained_ip_adapter_path="./pretrained_weight/ip.bin" \
      --pretrained_style_encoder_path="./pretrained_weight/style_aware_encoder.bin" \
      --image_encoder_path="{image_encoder_path}" \
      --image_json_file="{data.json}" \
      --image_root_path="{image_path}" \
      --mixed_precision="fp16" \
      --resolution=512 \
      --train_batch_size=16 \
      --dataloader_num_workers=4 \
      --learning_rate=1e-04 \
      --weight_decay=0.01 \
      --output_dir="{output_dir}" \
      --save_steps=10000
    

    StyleGallery

    We have carefully curated a style-balanced dataset, called StyleGallery, with extensive diverse image styles drawn from publicly available datasets for training our StyleShot. To prepare our dataset StyleGallery, please refer to tutorial, or download json file from here.

    StyleBench

    To address the lack of a benchmark in reference-based stylized generation, we establish a style evaluation benchmark containing 40 content images and 73 distinct styles across 490 reference images.

    Disclaimer

    This project strives to positively impact the domain of AI-driven image generation. Users are granted the freedom to create images using this tool, but they are expected to comply with local laws and utilize it in a responsible manner. The developers do not assume any responsibility for potential misuse by users.

    Citation

    If you find StyleShot useful for your research and applications, please cite using this BibTeX:

    @article{gao2024styleshot,
      title={Styleshot: A snapshot on any style},
      author={Gao, Junyao and Liu, Yanchen and Sun, Yanan and Tang, Yinhao and Zeng, Yanhong and Chen, Kai and Zhao, Cairong},
      journal={arXiv preprint arXiv:2407.01414},
      year={2024}
    }
    

    Acknowledgements

    The code is built upon IP-Adapter.