telugu-diffusion-lm

Telugu Diffusion Language Model

<div align="center"> <img src="https://img.shields.io/badge/Language-Telugu-blue" alt="Telugu"/> <img src="https://img.shields.io/badge/Model-Diffusion%20LM-green" alt="Diffusion LM"/> <img src="https://img.shields.io/badge/Status-Research%20Preview-yellow" alt="Research Preview"/> </div>

🌟 Overview

The first diffusion-based language model for Telugu! This model explores masked diffusion language modeling for Telugu text generation, adapting the MDLM (Masked Diffusion Language Models) architecture for an Indic language.

Unlike traditional autoregressive models (GPT-style), this model generates text through iterative denoising, starting from completely masked sequences and progressively revealing tokens.

Key Features

• ✅ First Telugu Diffusion LM: Novel application of diffusion modeling to Telugu
• ✅ Based on IndicBERTv2: Leverages strong Telugu language understanding
• ✅ Question-Answering: Fine-tuned on 93K Telugu Q&A pairs
• ✅ Bidirectional Context: Unlike autoregressive models, can consider full context
• ⚠️ Research Preview: See limitations section below

📊 Model Details

Training Details

Phase 1: Pretraining (Completed)

• Base model: IndicBERTv2-MLM-only
• Extended position embeddings (512 → 1024)
• Continued pretraining on Telugu text

Phase 2: SFT (Current)

• Dataset: maya-research/IndicVault (Telugu subset, ~50K filtered pairs)
• Objective: Diffusion-based instruction following
• Special tokens: <BOS>, <EOS>, <START_ID>, <END_ID>, <EOT_ID>
• Best validation loss: 2.60

Key Innovation: Query mask padding with 1s (instead of 0s) so the model learns to predict EOS tokens after answers, preventing repetitive generation.

🚀 Usage

Installation

pip install torch transformers safetensors streamlit

Basic Inference

import torch
from transformers import AutoModelForMaskedLM, AutoTokenizer
from safetensors.torch import load_file

# Load model and tokenizer
model_name = "Prahaladha/telugu-diffusion-lm"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForMaskedLM.from_pretrained(model_name)
model.eval()

device = "cuda" if torch.cuda.is_available() else "cpu"
model.to(device)

# Prepare input
question = "హెల్త్ కేర్ ఎక్స్పెన్సెస్ ని నా పర్సనల్ బడ్జెట్ లో ఎలా ఇంక్లూడ్ చేసుకోవాలి?"
chat = [{"role": "user", "content": question}]

# Apply chat template
result = tokenizer.apply_chat_template(
    chat,
    tokenize=True,
    add_generation_prompt=True,
)
prompt_ids = result if isinstance(result, list) else result["input_ids"]

# Prepare masked sequence
seq_len = 128
prompt_len = len(prompt_ids)
x = torch.full((1, seq_len), tokenizer.mask_token_id, dtype=torch.long, device=device)
x[0, :prompt_len] = torch.tensor(prompt_ids, device=device)

mask = torch.ones((1, seq_len), dtype=torch.bool, device=device)
mask[0, :prompt_len] = False

attn_mask = torch.ones((1, seq_len), dtype=torch.long, device=device)

# Diffusion generation
num_steps = 64
temperature = 0.7

times = torch.linspace(1.0, 0.0, num_steps + 1, device=device)

for t, s in zip(times[:-1], times[1:]):
    with torch.no_grad():
        logits = model(input_ids=x, attention_mask=attn_mask).logits
    
    # Sample masked positions
    if mask.any():
        masked_logits = logits[mask] / temperature
        probs = torch.softmax(masked_logits, dim=-1)
        sampled = torch.multinomial(probs, num_samples=1).squeeze(-1)
        x[mask] = sampled
    
    # Remask (random strategy)
    if s > 0:
        mask = mask & (torch.rand_like(mask, dtype=torch.float) < s / t)
        x[mask] = tokenizer.mask_token_id

# Decode answer
answer_ids = x[0, prompt_len:].tolist()
answer_tokens = [tid for tid in answer_ids 
                 if tid not in [tokenizer.mask_token_id, tokenizer.pad_token_id, tokenizer.eos_token_id]]

answer = tokenizer.decode(answer_tokens, skip_special_tokens=True)
print(f"Q: {question}")
print(f"A: {answer}")

Streamlit Demo

A full interactive demo is available in the repository:

streamlit run streamlit_app.py

📈 Performance

Strengths

• ✅ In-domain Performance: Good on questions similar to training data (IndicVault)
• ✅ Telugu Script: Handles Telugu characters properly
• ✅ Structured Output: Follows Q&A format consistently

Limitations

• ⚠️ Out-of-domain Generalization: Poor performance on simple prompts outside training distribution
• ⚠️ Limited Coverage: Training on 50K pairs may not cover diverse topics
• ⚠️ Repetition: Can generate repetitive text without early stopping
• ⚠️ Morphological Complexity: Telugu's agglutinative nature poses challenges
• ⚠️ Inference Speed: Slower than autoregressive models (requires multiple diffusion steps)

Comparison with Autoregressive Models

🎯 Intended Use

Primary Use Cases

• 🔬 Research: Exploring diffusion models for morphologically rich languages
• 📚 Experimentation: Understanding Telugu NLP with non-autoregressive approaches
• 🧪 Benchmarking: Comparing diffusion vs autoregressive generation for Indic languages

Out of Scope

• ❌ Production deployments (research preview only)
• ❌ Safety-critical applications
• ❌ General-purpose Telugu generation (limited to Q&A domain)

🔧 Training Hyperparameters

# SFT Phase
base_model: ai4bharat/IndicBERTv2-MLM-only
max_length: 1024
batch_size: 32
learning_rate: 5e-5
warmup_steps: 500
training_samples: ~50000
validation_loss: 2.60
optimizer: AdamW
scheduler: linear with warmup

📚 Datasets

• Training: maya-research/IndicVault (Telugu Q&A pairs, filtered)
• Pretraining: CC-100 Telugu, IndicCorp (via IndicBERTv2)

🙏 Acknowledgments

• AI4Bharat for IndicBERTv2-MLM-only base model
• Maya Research for IndicVault dataset
• MDLM paper (Sahoo et al., NeurIPS 2024) for the diffusion framework

📄 Citation

If you use this model in your research, please cite:

The base model and framework:

@inproceedings{kakwani2020indicnlpsuite,
    title={{IndicNLPSuite: Monolingual Corpora, Evaluation Benchmarks and Pre-trained Multilingual Language Models for Indian Languages}},
    author={Divyanshu Kakwani and Anoop Kunchukuttan and Satish Golla and Gokul N.C. and Avik Bhattacharyya and Mitesh M. Khapra and Pratyush Kumar},
    year={2020},
    booktitle={Findings of EMNLP},
}

@article{sahoo2024simple,
  title={Simple and Effective Masked Diffusion Language Models},
  author={Sahoo, Subham Sekhar and Arriola, Marianne and Schiff, Yair and Gokaslan, Aaron and Marroquin, Edgar and Chiang, Justin T and Voleti, Vikash and Galashov, Alexandre and Li, Cheng-Ping and Rish, Irina and others},
  journal={arXiv preprint arXiv:2406.07524},
  year={2024}
}

🤝 Contributing

This is a research project. Contributions, suggestions, and feedback are welcome!

Issues we're working on:

• Improving out-of-domain generalization
• Expanding training data coverage
• Optimizing inference speed
• Better handling of Telugu morphology

📧 Contact

• Creator: Prahaladha
• Model: Prahaladha/telugu-diffusion-lm
• Issues: Please report on the model repository

---

<div align="center"> <b>First Telugu Diffusion Language Model 🌸</b><br> <i>Exploring new frontiers in Indic language generation</i> </div>