Improve model card: add pipeline tag, library name, and paper link

README.md

@@ -1,10 +1,14 @@
 ---
 license: apache-2.0
+library_name: transformers
+pipeline_tag: text-generation
 ---
 
 # iLLaDA-8B-Base
 
 iLLaDA is an 8B fully bidirectional masked diffusion language model trained from scratch with 12T pre-training tokens, an 8192-token context length, variable-length generation, and confidence-based scoring for multiple-choice evaluation.
+It was introduced in the paper [Improved Large Language Diffusion Models](https://huggingface.co/papers/2606.25331).
+
 Inference and evaluation codes: https://github.com/ML-GSAI/LLaDA.
 
 ## Architecture
@@ -36,4 +40,29 @@ Inference and evaluation codes: https://github.com/ML-GSAI/LLaDA.
 | MATH | 38.4 | 31.4 | 39.6 | 41.1 |
 | HumanEval | 50.0 | 35.4 | 57.9 | 56.7 |
 | MBPP | 57.8 | 40.0 | 56.2 | 63.6 |
-| Average | 63.9 | 51.1 | 61.4 | 63.3 |
+| Average | 63.9 | 51.1 | 61.4 | 63.3 |
+
+## How to use
+
+You can load and use the model with `transformers` as follows:
+
+```python
+import torch
+from transformers import AutoModel, AutoTokenizer
+
+tokenizer = AutoTokenizer.from_pretrained('GSAI-ML/iLLaDA-8B-Base', trust_remote_code=True)
+model = AutoModel.from_pretrained('GSAI-ML/iLLaDA-8B-Base', trust_remote_code=True, torch_dtype=torch.bfloat16)
+```
+
+Refer to the [GitHub repository](https://github.com/ML-GSAI/LLaDA) for generation scripts such as `generate.py`.
+
+## Citation
+
+```bibtex
+@article{nie2026illada,
+  title={Improved Large Language Diffusion Models},
+  author={Nie, Shen and Min, Qiyang and Xu, Shaoxuan and Huang, Zihao and Song, Yuxuan and Shan, Yong and Lin, Yankai and Zhao, Wayne Xin and Li, Chongxuan and Wen, Ji-Rong},
+  journal={arXiv preprint arXiv:2606.25331},
+  year={2026}
+}
+```