Update README.md

README.md

@@ -1,3 +1,139 @@
----
-license: mit
----
+---
+license: mit
+---
+
+
+<div align="center">
+<h1>🚀 dParallel: Learnable Parallel Decoding for dLLMs</h1>
+  <div align="center">
+  <a href="https://opensource.org/license/mit-0">
+    <img alt="MIT" src="https://img.shields.io/badge/License-MIT-4E94CE.svg">
+  </a>
+  <a href="https://github.com/czg1225/dParallel">
+    <img src="https://img.shields.io/badge/Paper-Arxiv-darkred.svg" alt="Paper">
+  </a>
+  <a href="https://huggingface.co/Zigeng/dParallel-LLaDA-8b-instruct">
+    <img src="https://img.shields.io/badge/HuggingFace-Model-FFB000.svg" alt="Project">
+  </a>
+  <a href="https://huggingface.co/datasets/Zigeng/dParallel_LLaDA_Distill_Data">
+    <img src="https://img.shields.io/badge/HuggingFace-Data-FFB000.svg" alt="Project">
+  </a>
+</div>
+</div>
+
+> **dParallel: Learnable Parallel Decoding for dLLMs**   
+> [Zigeng Chen](https://github.com/czg1225), [Gongfan Fang](https://fangggf.github.io/), [Xinyin Ma](https://horseee.github.io/), [Ruonan Yu](https://scholar.google.com/citations?user=UHP95egAAAAJ&hl=en), [Xinchao Wang](https://sites.google.com/site/sitexinchaowang/)   
+> [xML Lab](https://sites.google.com/view/xml-nus), National University of Singapore  
+
+
+## 💡 Introduction
+We introduce dParallel, a simple and effective method that unlocks the inherent parallelism of dLLMs for fast sampling. We identify that the key bottleneck to parallel decoding arises from the sequential certainty convergence for masked tokens. Building on this insight, we introduce the core of our approach: certainty-forcing distillation, a novel training strategy that distills the model to follow its original sampling trajectories while enforcing it to achieve high certainty on masked tokens more rapidly and in parallel. Extensive experiments across various benchmarks demonstrate that our method can dramatically reduce the number of decoding steps while maintaining performance. When applied to the LLaDA-8B-Instruct model, dParallel reduces decoding steps from 256 to 30 on GSM8K, achieving an 8.5× speedup without performance degradation. On the MBPP benchmark, it cuts decoding steps from 256 to 24, resulting in a 10.5× speedup while maintaining accuracy.
+
+<!-- ![figure](assets/intro.png) -->
+<div align="center">
+  <img src="assets/method.png" width="100%" ></img>
+  <br>
+  <em>
+      Overview of proposed certainty-forcing distillation. 
+  </em>
+</div>
+<br>
+
+
+
+## 💻 Model and Datasets
+<table>
+<table>
+  <thead>
+  </thead>
+  <tbody>
+    <tr>
+      <td>📄 <strong>Paper</strong></td>
+      <td><a href="https://github.com/czg1225/dParallel">ArXiv-Link</a></td>
+    </tr>
+    <tr>
+      <td>🤖 <strong>Model</strong></td>
+      <td><a href="https://huggingface.co/Zigeng/dParallel-LLaDA-8b-instruct">dParallel-LLaDA-8b-instruct</a></td>
+    </tr>
+    <tr>
+      <td>📊 <strong>Data</strong></td>
+      <td><a href="https://huggingface.co/datasets/Zigeng/dParallel_LLaDA_Distill_Data">
+dParallel-LLaDA-Distill Dataset</a></td>
+    </tr>
+  </tbody>
+</table>
+
+## 🔥Updates
+* 🔥 **[Oct 2, 2025]**: Our arxiv paper is available.
+* 🔥 **[Oct 1, 2025]**: Code, model and dataset are released.
+
+## 🔧  Installation:
+
+```bash
+conda create -n dparallel python==3.10
+conda activate dparallel
+pip3 install -r requirements.txt
+```
+
+## 🚀 Quick Start:
+```python
+from transformers import AutoTokenizer
+from model.modeling_llada import LLaDAModelLM
+from generate import generate
+import torch
+
+device = 'cuda'
+model = LLaDAModelLM.from_pretrained('Zigeng/dParallel-LLaDA-8b-instruct', trust_remote_code=True, torch_dtype=torch.bfloat16).to(device).eval()
+tokenizer = AutoTokenizer.from_pretrained('Zigeng/dParallel-LLaDA-8b-instruct', trust_remote_code=True)
+
+prompt = "Natalia sold clips to 48 of her friends in April, and then she sold half as many clips in May. How many clips did Natalia sell altogether in April and May? Please reason step by step, and put your final answer within \\boxed{}."
+
+m = [{"role": "user", "content": prompt}, ]
+prompt = tokenizer.apply_chat_template(m, add_generation_prompt=True, tokenize=False)
+
+input_ids = tokenizer(prompt)['input_ids']
+input_ids = torch.tensor(input_ids).to(device).unsqueeze(0)
+
+out = generate(model, input_ids, steps=256, gen_length=256, block_length=32, temperature=0., threshold=0.5,remasking='low_confidence')
+print("Response:",tokenizer.batch_decode(out[0][:, input_ids.shape[1]:], skip_special_tokens=True)[0])
+print("NFE:",out[1])
+```
+
+
+## 🔥 Training
+### 1. Certainty-Forcing Distillation with LoRA:
+We provide training scripts for our proposed Certainty-Forcing Distillation process. The implementation utilizes LoRA during the training process, with the configuration details specified in [config_lora_llada.yaml](https://github.com/czg1225/dParallel/blob/master/configs/config_lora_llada.yaml).
+```bash
+deepspeed --master_port 29501 --include localhost:0,1,2,3 llada_train.py
+```
+
+### 2. LoRA Merge:
+After training, merge the LoRA weights to get the dParallel-dLLM.
+```bash
+python merge_lora.py
+```
+
+## ⚡ Evaluation:
+We provide evaluation scripts for the GSM8K, Minerva_MATH, HumanEval, and MBPP benchmarks. Although our approach does not rely on caching or sparse attention techniques, it is fully compatible with them and can achieve even greater speedups when combined.
+```bash
+sh eval.sh
+```
+
+
+## 📖 Experimental Results
+### Results on LLaDA-8B-Instruct:
+![llada-exp](assets/llada_exp.png)
+
+### Results on Dream-7B-Instruct:
+![dream-exp](assets/dream_exp.png)
+
+### Better Speed-Accuracy Trade-off:
+![trade-off](assets/trade-off.png)
+
+## ☀️ Acknowledgement
+Our code builds on [LLaDA](https://github.com/ML-GSAI/LLaDA), [Dream](https://github.com/DreamLM/Dream), [Fast-dLLM](https://github.com/NVlabs/Fast-dLLM/tree/main), and [dKV-Cache](https://github.com/horseee/dkv-cache), and we acknowledge these great works for laying the groundwork that made our approach possible.
+
+## Citation
+If our research assists your work, please give us a star ⭐ or cite us using:
+```
+```