cstr/bge-reranker-v2-m3-GGUF

bge-reranker-v2-m3 GGUF

GGUF format of BAAI/bge-reranker-v2-m3 for use with CrispEmbed.

BGE Reranker v2 M3. Multilingual cross-encoder reranker (100+ languages). 2-layer classification head. Use with crispembed_rerank().

Files

File	Quantization	Size
bge-reranker-v2-m3-q4_k.gguf	Q4_K	437 MB
bge-reranker-v2-m3-q8_0.gguf	Q8_0	582 MB
bge-reranker-v2-m3.gguf	F32	2171 MB

Quick Start

# Download
huggingface-cli download cstr/bge-reranker-v2-m3-GGUF bge-reranker-v2-m3-q4_k.gguf --local-dir .

# Run with CrispEmbed
./crispembed -m bge-reranker-v2-m3-q4_k.gguf "Hello world"

# Or with auto-download
./crispembed -m bge-reranker-v2-m3 "Hello world"

Model Details

Property	Value
Architecture	XLM-RoBERTa
Parameters	568M
Embedding Dimension	1024
Layers	24
Pooling	CLS
Tokenizer	SentencePiece
Base Model	BAAI/bge-reranker-v2-m3

Verification

Verified bit-identical to HuggingFace sentence-transformers (cosine similarity >= 0.999 on test texts).

Usage with CrispEmbed

CrispEmbed is a lightweight C/C++ text embedding inference engine using ggml. No Python runtime, no ONNX. Supports BERT, XLM-R, Qwen3, and Gemma3 architectures.

# Build CrispEmbed
git clone https://github.com/CrispStrobe/CrispEmbed
cd CrispEmbed
cmake -S . -B build && cmake --build build -j

# Encode
./build/crispembed -m bge-reranker-v2-m3-q4_k.gguf "query text"

# Server mode
./build/crispembed-server -m bge-reranker-v2-m3-q4_k.gguf --port 8080
curl -X POST http://localhost:8080/v1/embeddings \
    -d '{"input": ["Hello world"], "model": "bge-reranker-v2-m3"}'

Credits

• Original model: BAAI/bge-reranker-v2-m3
• Inference engine: CrispEmbed (ggml-based)
• Conversion: convert-bert-embed-to-gguf.py