Improve model card: update pipeline tag, add library, and detailed content

This PR significantly enhances the model card for `Kwai-Kolors/CoTyle`.

Key improvements include:
- **Updated Metadata**:
- Corrected the `pipeline_tag` from `image-text-to-text` to `text-to-image`, accurately reflecting the model's functionality (generating images from text prompts and a style code).
- Added `library_name: diffusers`, as the model is built upon and compatible with the Diffusers library, enabling better integration and discoverability on the Hub.
- **Comprehensive Content**:
- Incorporated a detailed introduction, news, ToDo list, and the abstract directly from the paper's GitHub README.
- Included prominent links and badges to the paper, project page, Hugging Face demo, Hugging Face model, and the GitHub repository.
- Provided detailed "Quick Start" instructions, including environment setup, download steps, and command-line usage examples for both single and batch image generation, directly from the GitHub README.
- Added information about the Gradio app for local interactive inference.
- Included the full academic citation and acknowledgements.

This update makes the model card much more informative and user-friendly for anyone exploring the `CoTyle` model.

README.md

@@ -1,8 +1,176 @@
 ---
-license: mit
 base_model:
 - Kwai-Kolors/Kolors-CoTyle
-pipeline_tag: image-text-to-text
+license: mit
+pipeline_tag: text-to-image
 tags:
 - art
----
+library_name: diffusers
+---
+
+# 🎨 A Style is Worth One Code: Unlocking Code-to-Style Image Generation with Discrete Style Space
+<p align="center"> 
+    <a href="https://arxiv.org/abs/2511.10555"><img alt="Build" src="https://img.shields.io/badge/arXiv-Paper-da282a.svg"></a>
+    <a href="https://Kwai-Kolors.github.io/CoTyle/"><img alt="Build" src="https://img.shields.io/badge/Project%20Page-Homepage-yellow"></a> 
+    <a href="https://github.com/Kwai-Kolors/CoTyle"><img alt="Build" src="https://img.shields.io/badge/GitHub-Code-f8f0f0.svg"></a> 
+    <a href="https://huggingface.co/spaces/Kwai-Kolors/CoTyle"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-32CD32"></a>
+    <a href="https://huggingface.co/Kwai-Kolors/CoTyle"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Model-fd8b02"></a>
+</p>
+
+<p align="center">
+    <span style="color:#137cf3; font-family: Gill Sans">Huijie Liu</span><sup>1,2</sup>,
+    <span style="color:#137cf3; font-family: Gill Sans">Shuhao Cui</span><sup>2</sup>,
+    <span style="color:#137cf3; font-family: Gill Sans">Haoxiang Cao</span><sup>2,3</sup>,
+    <span style="color:#137cf3; font-family: Gill Sans">Shuai Ma</span><sup>1</sup>,
+    <span style="color:#137cf3; font-family: Gill Sans">Kai Wu</span><sup>2,†</sup>,
+    <span style="color:#137cf3; font-family: Gill Sans">Guoliang Kang</span><sup>1,†</sup>
+    <br>
+    <sup>1</sup><span style="font-size: 16px">Beihang University</span>,
+    <sup>2</sup><span style="font-size: 16px">Kolors Team, Kuaishou Technology</span>, 
+    <sup>3</sup><span style="font-size: 16px">South China Normal University</span>
+    <br>
+    <sup>†</sup><span style="font-size: 16px">Co-Corresponding Author</span>
+</p>
+
+> This repository offers the official code of the paper *"A Style is Worth One Code: Unlocking Code-to-Style Image Generation with Discrete Style Space"*. We provide both an Open-Source Version (based on Qwen-Image) and a Commercial Version (based on Kolors). If you are a professional developer and interested in further developing the CoTyle Open-Source Version, please follow the tutorial below. The Commercial Version is coming soon.
+
+<p align="center">
+<img src="https://github.com/Kwai-Kolors/CoTyle/raw/main/assets/2-fig1_01.png" width=95% height=95% 
+class="center">
+</p>
+
+
+## 🔥 News
+- [11/18/2025] The [demo](https://huggingface.co/spaces/Kwai-Kolors/CoTyle) of CoTyle is released on Hugging Face.
+- [11/18/2025] The [weights](https://huggingface.co/Kwai-Kolors/CoTyle) of CoTyle are released on Hugging Face.
+- [11/18/2025] The [code](https://github.com/Kwai-Kolors/CoTyle) is released!
+- [11/18/2025] The [homepage](https://Kwai-Kolors.github.io/CoTyle/) of CoTyle is released.
+- [11/14/2025] The [paper](https://arxiv.org/abs/2511.10555) of CoTyle is released.
+
+## 📝 ToDo
+- [x] Publish the paper on Arxiv.
+- [x] Release the homepage of CoTyle.
+- [x] Launch a free demo on Hugging Face Spaces of CoTyle.
+- [x] Open source the code and model weights of CoTyle.
+- [ ] Release the commercial version of CoTyle.
+
+## 📖 Abstract
+Innovative visual stylization is a cornerstone of artistic creation, yet generating novel and consistent visual styles remains a significant challenge. Existing generative approaches typically rely on lengthy textual prompts, reference images, or parameter-efficient fine-tuning to guide style-aware image synthesis, but often struggle with style consistency, limited novelty, and complex style representations. In this paper, we affirm that a style is worth one numerical code by introducing the novel task, code-to-style image generation, which produces images with novel, consistent visual styles conditioned solely on a numerical style code. To date, this field has only been primarily explored by the industry (e.g., Midjourney), with no open-source research from the academic community. To fill this gap,
+we propose CoTyle, the first open-source method for this task. Specifically, we first train a discrete style codebook from a collection of images to extract style embeddings. These embeddings are used to condition a text-to-image diffusion model (T2I-DM) for style-consistent generation. Subsequently, we train an autoregressive transformer on the quantized style codes to model their distribution, allowing the synthesis of novel style codes. During inference, a numerical code maps to a unique style sequence,
+which guides the diffusion process to produce images in the corresponding style. Unlike existing methods, our approach offers unparalleled simplicity and diversity, unlocking a vast space of reproducible styles from minimal input. Extensive experiments validate that CoTyle effectively turns a numerical code into a style controller, demonstrating a style is worth one code.
+
+## ⚡️ Quick Start
+### 🔧 Requirements and Installation
+Run the following command to install the requirements.
+```bash
+git clone https://github.com/Kwai-Kolors/CoTyle
+cd CoTyle
+conda create -n cotyle python=3.10 
+conda activate cotyle
+pip install torch==2.6.0 torchvision==0.21.0
+pip install -e git+https://github.com/Lakonik/piFlow.git@b1ef16e5e305251bccdfeac2a0e3d0ef339b974a#egg=lakonlab --no-build-isolation
+pip install -r requirements.txt
+# After running, some dependency errors may appear (don’t meet lakonlab’s requirements). 
+# This is normal and can be ignored.
+```
+
+### ⏬ Download
+Please download the checkpoints and put them to the `./pretrained_models` directory.
+You can download them from [Hugging Face](https://huggingface.co/Kwai-Kolors/CoTyle/tree/main).
+```bash
+git lfs install
+git clone https://huggingface.co/Kwai-Kolors/CoTyle
+mv CoTyle pretrained_models
+```
+
+### 🚄 Code-to-Style Generation
+For a quick walkthrough of the inference pipeline, we recommend generating a single image (see Single-Sample Generation).
+To intuitively experience the powerful capabilities of CoTyle, we recommend generating a batch of images (see Batch-Sample Generation), which by default produces 42 images (7 style codes × 6 prompts).
+
+
+#### Batch-Samples Generation
+Run the following command to generate a batch of images. By default, 7 rows and 6 columns of images will be generated, where all images in each row are produced using the same style code, and all images in each column are generated using the same prompt. 
+You can adjust the `--style_code` and the content in `./test_prompts.txt` to obtain the desired outputs.
+
+This process may take considerable time. 
+Therefore, we provide an accelerated version based on [piFlow](https://github.com/Lakonik/piFlow), which requires only 4 denoising steps; however, this approach produces lower image quality.
+Enable `--accelerate` to activate piFlow.
+```bash
+python inference_batch.py --model_path ./pretrained_models \
+  --style_code 1234567 5201314 13415926 886 20010627 996007 2333 \
+  --prompt_file_path ./test_prompts.txt \
+  --output_path outputs \
+  --seed 1024 \
+  --accelerate
+```
+
+If time permits, we strongly recommend executing the command below.
+```bash
+python inference_batch.py --model_path ./pretrained_models \
+  --style_code 1234567 5201314 13415926 886 20010627 996007 2333 \
+  --prompt_file_path ./test_prompts.txt \
+  --output_path outputs \
+  --seed 1024 \
+```
+
+After successful execution, you will obtain the following results:
+<p align="center">
+<img src="https://github.com/Kwai-Kolors/CoTyle/raw/main/assets/batch_example.png" width=95% height=95% 
+class="center">
+</p>
+
+
+#### Single-Sample Generation
+Execute the following code for single-sample inference. You can generate desired results by adjusting the `--style_code` and `--prompt`.
+
+```bash
+python inference.py --model_path ./pretrained_models \
+  --style_code 1234567 \
+  --prompt "A lovely crystal snake spirit, slender and nimble, wears an exquisite crystal crown atop its head. Its scales are translucent, shimmering like crystal, its eyes are bright and round, and its expression is lively. Its body coils naturally, its tail gracefully curved, its overall posture harmonious and beautiful." \
+  --output_path outputs \
+  --seed 1024
+```
+Similarly, you can enable the `--accelerate` to speed up.
+
+## 📲 Gradio Apps
+We provide Gradio apps for interactivate inference with the CoTyle.
+
+Official apps are available on [HuggingFace Spaces](https://huggingface.co/spaces/Kwai-Kolors/CoTyle).
+
+
+If you want to run it locally, please execute:
+```bash
+python app.py
+```
+
+<strong>Note</strong>: The Gradio apps use an accelerated version, which may result in a slight reduction in image generation quality.
+
+<strong>Tips</strong>:
+- Adjust the <strong>Number of Prompts</strong> slider to add or remove input rows.
+- Type your own prompts directly in the text boxes .
+- You can click any template below to quickly load preset style code and prompts.
+<p align="center">
+<img src="https://github.com/Kwai-Kolors/CoTyle/raw/main/assets/demo.png" width=95% height=95% 
+class="center">
+</p>
+
+
+
+## 🌟 Citation
+If CoTyle is helpful, please help to ⭐ the repo.
+
+If you find this project useful for your research, please consider citing our paper:
+```bibtex
+@misc{liu2025styleworthcodeunlocking,
+      title={A Style is Worth One Code: Unlocking Code-to-Style Image Generation with Discrete Style Space}, 
+      author={Huijie Liu and Shuhao Cui and Haoxiang Cao and Shuai Ma and Kai Wu and Guoliang Kang},
+      year={2025},
+      eprint={2511.10555},
+      archivePrefix={arXiv},
+      primaryClass={cs.CV},
+      url={https://arxiv.org/abs/2511.10555}, 
+}
+```
+
+## 💌 Acknowledge
+This code builds on [diffusers](https://huggingface.co/docs/diffusers/index), [Qwen-Image](https://github.com/QwenLM/Qwen-Image), [piFlow](https://github.com/Lakonik/piFlow) and [UniTok](https://github.com/FoundationVision/UniTok). Thanks for open-sourcing!