Noql: A Tiny and Efficient Persian Text Embedding Model

Noql is a Persian sentence embedding model with only 12M parameters. It is trained with Matryoshka representation learning, so its 768-dimensional embeddings can be truncated to 512, 256, 128 or 64 dimensions with little loss in quality.

Training

Noql was trained on the Shiraz dataset in three stages:

1. Positive pairs: query–document pairs with in-batch negatives (2M samples).
2. Hard negatives: half positive pairs, half pairs with mined hard negatives (2M samples).
3. Paraphrases and hard negatives: LLM-written paraphrases of Shiraz sentences and paragraphs (formal and colloquial), each with four hard negatives that keep nearly the same wording but change the meaning. These were mixed with about nine batches of query–document pairs with mined hard negatives for every paraphrase batch (1.8M triplets), so retrieval is preserved while the model learns finer distinctions of meaning.

Usage

pip install -U sentence-transformers

from sentence_transformers import SentenceTransformer

model = SentenceTransformer("shekar-ai/Noql")

sentences = [
    "پایتخت ایران تهران است.",
    "تهران بزرگ‌ترین شهر ایران است.",
    "امروز هوا بارانی است.",
]
embeddings = model.encode(sentences)
print(model.similarity(embeddings, embeddings))
# tensor([[1.0000, 0.9082, 0.1614],
#         [0.9082, 1.0000, 0.1654],
#         [0.1614, 0.1654, 1.0000]])

Retrieval

query = "بهترین زمان برای سفر به شیراز چه موقع است؟"
documents = [
    "بهار به دلیل هوای معتدل و شکوفه‌های نارنج بهترین فصل سفر به شیراز است.",
    "قیمت طلا در بازار امروز کاهش یافت.",
    "حافظیه و سعدیه از جاذبه‌های معروف شیراز هستند.",
]
scores = model.similarity(model.encode(query), model.encode(documents))
print(scores)
# tensor([[ 0.6919, -0.1672,  0.5561]])

Smaller embeddings

model = SentenceTransformer("shekar-ai/Noql", truncate_dim=256)
embeddings = model.encode(documents)  # shape: (3, 256)

Evaluation

Results on FaMTEB (MTEB(fas, v2), all 52 tasks) at each embedding size.

Citation

@article{Amirivojdan2025Shekar,
  author  = {Amirivojdan, Ahmad},
  title   = {{Shekar: A Python Toolkit for Persian Natural Language Processing}},
  journal = {Journal of Open Source Software},
  volume  = {10},
  number  = {114},
  pages   = {9128},
  year    = {2025},
  doi     = {10.21105/joss.09128},
  url     = {https://joss.theoj.org/papers/10.21105/joss.09128}
}