Text Ranking
Transformers
ONNX
Safetensors
sentence-transformers
Transformers.js
modernbert
text-classification
reranker
cross-encoder
mmbert
text-embeddings-inference
Instructions to use Horizon-Labs/multilingual-reranker-base with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Horizon-Labs/multilingual-reranker-base with Transformers:
# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForSequenceClassification tokenizer = AutoTokenizer.from_pretrained("Horizon-Labs/multilingual-reranker-base") model = AutoModelForSequenceClassification.from_pretrained("Horizon-Labs/multilingual-reranker-base", device_map="auto") - sentence-transformers
How to use Horizon-Labs/multilingual-reranker-base with sentence-transformers:
from sentence_transformers import CrossEncoder model = CrossEncoder("Horizon-Labs/multilingual-reranker-base") query = "Which planet is known as the Red Planet?" passages = [ "Venus is often called Earth's twin because of its similar size and proximity.", "Mars, known for its reddish appearance, is often referred to as the Red Planet.", "Jupiter, the largest planet in our solar system, has a prominent red spot.", "Saturn, famous for its rings, is sometimes mistaken for the Red Planet." ] scores = model.predict([(query, passage) for passage in passages]) print(scores) - Transformers.js
How to use Horizon-Labs/multilingual-reranker-base with Transformers.js:
// npm i @huggingface/transformers import { AutoTokenizer, AutoModelForSequenceClassification } from '@huggingface/transformers'; const tokenizer = await AutoTokenizer.from_pretrained('Horizon-Labs/multilingual-reranker-base'); const model = await AutoModelForSequenceClassification.from_pretrained('Horizon-Labs/multilingual-reranker-base'); const query = 'Which planet is known as the Red Planet?'; const documents = [ 'Mars, known for its reddish appearance, is often referred to as the Red Planet.', 'Venus is often called the twin of Earth because of its similar size and proximity.', ]; const inputs = tokenizer(new Array(documents.length).fill(query), { text_pair: documents, padding: true, truncation: true }); const { logits } = await model(inputs); console.log(logits.sigmoid().tolist()); // one relevance score per document - Notebooks
- Google Colab
- Kaggle
Download code/rerank/quant_check.py from Horizon-Labs/multilingual-reranker-base: direct link, hf CLI and curl.
- Browser
- Download file 2.4 kB
-
https://huggingface.co/Horizon-Labs/multilingual-reranker-base/resolve/main/code/rerank/quant_check.py
- Command line
-
hf download hf://Horizon-Labs/multilingual-reranker-base/code/rerank/quant_check.py
-
curl -L -o quant_check.py https://huggingface.co/Horizon-Labs/multilingual-reranker-base/resolve/main/code/rerank/quant_check.py
2.4 kB
| """int8 (gather-only) ONNX check for a reranker. python rerank/quant_check.py MODEL_DIR EVAL_DIR | |
| Quantizes onnx/model.onnx -> onnx/model_quantized.onnx (embedding Gather only) and compares with fp32 ONNX on (query, | |
| passage) pairs from the first candidates of 4 eval sets: mean / max |sigmoid difference| and nDCG@10 on those sets. | |
| Writes MODEL_DIR/onnx_sweep.json (same keys as train/quant_sweep.py: gather_only.{mean_diff,max_diff,mb}, n).""" | |
| import glob, json, math, os, sys | |
| import numpy as np, pandas as pd, onnxruntime as ort | |
| from onnxruntime.quantization import quantize_dynamic, QuantType | |
| from transformers import AutoTokenizer | |
| d, ev = sys.argv[1:3] | |
| tok = AutoTokenizer.from_pretrained(d) | |
| sets = [p for p in sorted(glob.glob(f"{ev}/*.parquet")) if os.path.basename(p).split(".")[0] in ("miracl_de", "miracl_zh", "wiki_en", "esci_jp", "rubq")] | |
| data = [(pd.read_parquet(p).head(12)) for p in sets] | |
| so = ort.SessionOptions(); so.intra_op_num_threads = 8 | |
| def run(path): | |
| s = ort.InferenceSession(path, so, providers=["CPUExecutionProvider"]); allp = []; nd = [] | |
| for df in data: | |
| for q, docs, rels in zip(df["query"], df.docs, df.rels): | |
| docs = list(docs)[:30]; rels = list(rels)[:30] | |
| e = tok([q] * len(docs), docs, truncation="only_second", max_length=384, padding=True, return_tensors="np") | |
| lo = s.run(None, {"input_ids": e["input_ids"], "attention_mask": e["attention_mask"]})[0][:, 0] | |
| allp += list(1 / (1 + np.exp(-lo))) | |
| order = np.argsort(-lo)[:10]; ideal = sorted(rels, reverse=True)[:10] | |
| idcg = sum((2 ** r - 1) / math.log2(k + 2) for k, r in enumerate(ideal)) | |
| nd.append(sum((2 ** rels[i] - 1) / math.log2(k + 2) for k, i in enumerate(order)) / idcg if idcg else 0) | |
| return np.array(allp), float(np.mean(nd)) | |
| ref, nd_ref = run(f"{d}/onnx/model.onnx") | |
| quantize_dynamic(f"{d}/onnx/model.onnx", f"{d}/onnx/model_quantized.onnx", weight_type=QuantType.QInt8, op_types_to_quantize=["Gather"]) | |
| q, nd_q = run(f"{d}/onnx/model_quantized.onnx") | |
| r = dict(gather_only=dict(mean_diff=float(np.abs(q - ref).mean()), max_diff=float(np.abs(q - ref).max()), ndcg_fp32=nd_ref, ndcg_int8=nd_q, | |
| mb=os.path.getsize(f"{d}/onnx/model_quantized.onnx") / 1e6), n=int(len(ref)), best="gather_only") | |
| json.dump(r, open(f"{d}/onnx_sweep.json", "w"), indent=1); print(r, flush=True) | |