deepvk / GeRaCl-USER2-base

GeRaCl-USER2-base

GeRaCl is a Ge neral Ra pid Cl assifer designed to perform zero-shot classification tasks primarily on Russian texts.

This is a model with 155M parameters that is build on top of the USER2-base sentence encoder (149M) and is fine-tuned for zero-shot classification task.

What is Zero‑Shot Classification?

Zero‑shot text classification lets a model assign user‑supplied labels to a text without seeing any training examples for those labels. At inference you simply provide the candidate labels as strings, and the model chooses the most appropriate one.

Performance

To evaluate the model, we measure quality on multiclass classification tasks from the MTEB-rus benchmark.

MTEB-rus

How comparison was performed

1. NLI‑Encoders were used via 🤗 pipeline("zero-shot-classification")

Models such as mDeBERTa-v3-base-mnli-xnli and bge-m3-zeroshot-v2.0 are pre‑trained on Natural Language Inference corpora.The Hugging Face pipeline converts classification into NLI hypotheses like:

Premise: text

Hypothesis: "This text is about {label}."

The model scores each (premise, hypothesis) pair independently; the label with the highest entailment probability wins.

1. LLMs prompted for classification

Large‑language models such as Qwen2.5‑1.5B and Qwen2.5‑3B are queried with a simple classification prompt:

PROMPT = """Ниже указан текст. Ты должен присвоить ему один из перечисленных ниже классов.

Текст:
{}

Классы:
{}.

Твой ответ должен состоять только из выбранного класса, ничего другого.
"""

1. GeRaCl architecture. Detailed information about this architecture is located in Training Detais section.

Installation

Clone and install directly from GitHub:

git clone https://github.com/deepvk/geracl
cd geracl

pip install -r requirements.txt

Verify your installation:

import geracl
print(geracl.__version__)

Usage

Single classification scenario

from transformers import AutoTokenizer
from geracl import GeraclHF, ZeroShotClassificationPipeline

model = GeraclHF.from_pretrained('deepvk/GeRaCl-USER2-base').to('cuda').eval()
tokenizer  = AutoTokenizer.from_pretrained('deepvk/GeRaCl-USER2-base')

pipe = ZeroShotClassificationPipeline(model, tokenizer, device="cuda")

text = "Утилизация катализаторов: как неплохо заработать"
labels = ["экономика", "происшествия", "политика", "культура", "наука", "спорт"]
result = pipe(text, labels, batch_size=1)[0]

print(labels[result])

Multiple classification scenarios

from transformers import AutoTokenizer
from geracl import GeraclHF, ZeroShotClassificationPipeline

model = GeraclHF.from_pretrained('deepvk/GeRaCl-USER2-base').to('cuda').eval()
tokenizer  = AutoTokenizer.from_pretrained('deepvk/GeRaCl-USER2-base')

pipe = ZeroShotClassificationPipeline(model, tokenizer, device="cuda")

texts = [
  "Утилизация катализаторов: как неплохо заработать",
  "Мне не понравился этот фильм"
]
labels = [
  ["экономика", "происшествия", "политика", "культура", "наука", "спорт"],
  ["нейтральный", "позитивный", "негативный"]
]
results = pipe(texts, labels, batch_size=2)

for i in range(len(labels)):
    print(labels[i][results[i]])

Training details

This is the base version with 155 million parameters, based on USER2-base sentence encoder. This model uses similar to GLiNER idea, but it has only one vector of similarity scores instead of a full matrix of similarities. Compared to the USER2-base model, there are two additional MLP layers. One is for the text embeddings and another is for the classes embeddings. You can see the detailed model's architecture on the picture below.

The training set is built entirely from splits of the deepvk/GeRaCl_synthethic_dataset dataset. It is a concatenation of three sub-datasets:

• Synthetic classes part . For every training example we randomly chose one of the five class lists ( classes_0 … classes_4 ) and paired it with the sample’s text. The validation and test splits were added unchanged.
• RU-MTEB part . The entire ru_mteb_classes dataset was added to the mix.
• RU-MTEB extended part . The entire ru_mteb_extended_classes dataset was added to the mix.

Citations

@misc{deepvk2025geracl,
    title={GeRaCl},
    author={Vyrodov, Mikhail and Spirin, Egor and Sokolov Andrey},
    url={https://huggingface.co/deepvk/GeRaCl-USER2-base},
    publisher={Hugging Face}
    year={2025},
}