Mizan-Rerank-v1

Mizan-Rerank-v1

A compact open-source cross-encoder for reranking Arabic long texts, built for maximum accuracy per parameter.

---

Deprecated: use Mizan-Rerank-v3

This model is deprecated and no longer maintained. Use Mizan-Rerank-v3 instead.

v3 is a 306M-parameter cross-encoder fine-tuned from Alibaba-NLP/gte-multilingual-reranker-base on 71k Arabic listwise groups, with adversarial traps (negated rulings, swapped entities, shifted numbers and dates) as hard negatives. It is the most accurate Arabic reranker in the Mizan family, it runs about twice as fast as bge-reranker-v2-m3, and it is built for RAG pipelines, long-document retrieval and domain-specific Arabic search.

v3 covers the use cases v1 was built for, at 306M parameters and full speed, so there is no reason to start a new project on v1. This card is kept online for reproducibility of existing work.

v1 vs. v3 at a glance

Migrating is a one-line change — see Migrating to v3 below.

---

Overview

Mizan-Rerank-v1 is an open-source reranking model based on the ModernBERT architecture, designed for reordering search results over Arabic text. At only 149 million parameters it targets the efficiency end of the spectrum: it runs comfortably in about 1 GB of memory while still handling documents up to 8192 tokens.

Key Features

• Lightweight: 149M parameters, roughly half to a quarter the size of common multilingual rerankers (278M–568M)
• Long text processing: Accepts up to 8192 tokens
• Fast inference: Around 0.1 s response time on a single RTX 4090
• Arabic language optimization: Trained specifically for Arabic morphology and context
• Low memory footprint: ~1 GB VRAM, making it viable on modest GPUs and CPU-bound deployments

Performance Benchmarks

Hardware Performance (RTX 4090 24GB)

Efficiency was v1's primary advantage when it was released, and it remains the smallest model in the Mizan family. It is no longer a reason to adopt it: v3 is more accurate and faster per pair than bge-reranker-v2-m3 at 306M parameters.

Ranking Quality (ndcg@10)

The table below comes from the evaluation run used for the v2 release, so all models are measured under identical conditions and the numbers are directly comparable. It predates v3.

v1 stays competitive with models 2–4× its size on the saturated reranking and triplet sets. The gap widens on long-document MIRACL and on domain-specific sets such as MedQA, which is what the later Mizan models were built to close.

Note on earlier figures: the original v1 model card reported a MIRACL ndcg@10 of 0.8865, measured on a different evaluation subset and protocol. The table above supersedes it and should be used for any comparison against later rerankers.

Training Methodology

Mizan-Rerank-v1 was trained on a corpus of 741,159,981 tokens drawn from:

• Authentic Arabic open-source datasets
• Manually curated and processed text
• Purpose-generated synthetic data

How It Works

1. Query reception: The model receives a user query alongside candidate passages
2. Content analysis: It jointly encodes each query–passage pair and analyzes their semantic relationship
3. Relevance scoring: It assigns a relevance score to each passage
4. Reranking: Passages are sorted by descending score

Usage

Using Transformers

from transformers import AutoModelForSequenceClassification, AutoTokenizer
import torch

model = AutoModelForSequenceClassification.from_pretrained("ALJIACHI/Mizan-Rerank-v1")
tokenizer = AutoTokenizer.from_pretrained("ALJIACHI/Mizan-Rerank-v1")
model.eval()

def get_relevance_score(query, passage):
    inputs = tokenizer(
        query, passage,
        return_tensors="pt", padding=True, truncation=True, max_length=8192,
    )
    with torch.no_grad():
        logits = model(**inputs).logits
    # Apply sigmoid to map the raw logit into a 0–1 relevance probability
    return torch.sigmoid(logits).item()

query = "ما هو تفسير الآية وجعلنا من الماء كل شيء حي"
passages = [
    "تعني الآية أن الماء هو عنصر أساسي في حياة جميع الكائنات الحية، وهو ضروري لاستمرار الحياة.",
    "تم اكتشاف كواكب خارج المجموعة الشمسية تحتوي على مياه متجمدة.",
    "تحدث القرآن الكريم عن البرق والرعد في عدة مواضع مختلفة.",
]

scores = [(p, get_relevance_score(query, p)) for p in passages]
reranked = sorted(scores, key=lambda x: x[1], reverse=True)

for passage, score in reranked:
    print(f"Score: {score:.4f} | {passage}")

Using Sentence Transformers

pip install -U sentence-transformers

from sentence_transformers import CrossEncoder

model = CrossEncoder("ALJIACHI/Mizan-Rerank-v1", max_length=8192)

ranks = model.rank(
    "ما هي فوائد فيتامين د؟",
    [
        "يساعد فيتامين د في تعزيز صحة العظام وتقوية الجهاز المناعي، كما يلعب دوراً مهماً في امتصاص الكالسيوم.",
        "يستخدم فيتامين د في بعض الصناعات الغذائية كمادة حافظة.",
        "يمكن الحصول على فيتامين د من خلال التعرض لأشعة الشمس أو تناول مكملات غذائية.",
    ],
)
print(ranks)

Migrating to v3

The interface is identical; only the model ID changes, plus trust_remote_code=True for v3's custom architecture:

from sentence_transformers import CrossEncoder

# Before
model = CrossEncoder("ALJIACHI/Mizan-Rerank-v1", max_length=8192)

# After
model = CrossEncoder("ALJIACHI/Mizan-Rerank-v3", max_length=3072, trust_remote_code=True)

Scores are not calibrated across versions, so if your pipeline uses an absolute score threshold to filter candidates, re-tune that threshold after switching. Full details, benchmarks and a usage guide are on the v3 model card.

Practical Examples

Example 1

السؤال: ما هو القانون الجديد بشأن الضرائب في 2024؟

Example 2

السؤال: ما هو تفسير الآية وجعلنا من الماء كل شيء حي

Example 3

السؤال: ما هي فوائد فيتامين د؟

Example 3 illustrates a known v1 weakness: it separates relevant from irrelevant text reliably, but its scores are less discriminative among passages that merely mention the query topic. Later Mizan models handle this case better.

Model Details

• Model Type: Cross Encoder
• Base Model: answerdotai/ModernBERT-base
• Parameters: 149M
• Maximum Sequence Length: 8192 tokens
• Number of Output Labels: 1
• Language: Arabic (ar), English (en)
• License: Apache 2.0
• Status: deprecated
• Replacement: ALJIACHI/Mizan-Rerank-v3

Applications

• Specialized Arabic search engines
• Archiving systems and digital libraries
• RAG (Retrieval-Augmented Generation) pipelines
• Conversational AI applications
• E-learning platforms
• Information retrieval systems

For all of the above, use v3. This model is deprecated and is documented here only for reproducibility of existing work.

Citation

If you use Mizan-Rerank-v1 in your research, please cite:

@software{Mizan_Rerank_v1_2025,
  author = {Ali Aljiachi},
  title = {Mizan-Rerank-v1: A Revolutionary Arabic Text Reranking Model},
  year = {2025},
  publisher = {Hugging Face},
  url = {https://huggingface.co/ALJIACHI/Mizan-Rerank-v1}
}

For the recommended successor model:

@software{Mizan_Rerank_v3_2026,
  author = {Ali Aljiachi},
  title = {Mizan-Rerank-v3: Adversarially Trained Arabic Long-Context Reranker},
  year = {2026},
  publisher = {Hugging Face},
  url = {https://huggingface.co/ALJIACHI/Mizan-Rerank-v3}
}

Base model:

@misc{modernbert,
      title={Smarter, Better, Faster, Longer: A Modern Bidirectional Encoder for Fast, Memory Efficient, and Long Context Finetuning and Inference},
      author={Benjamin Warner and Antoine Chaffin and Benjamin Clavié and Orion Weller and Oskar Hallström and Said Taghadouini and Alexis Gallagher and Raja Biswas and Faisal Ladhak and Tom Aarsen and Nathan Cooper and Griffin Adams and Jeremy Howard and Iacopo Poli},
      year={2024},
      eprint={2412.13663},
      archivePrefix={arXiv},
      primaryClass={cs.CL},
      url={https://arxiv.org/abs/2412.13663},
}

License

The Mizan-Rerank-v1 model weights are released under the Apache 2.0 License.