Instructions to use thinletter/bge-m3-query-clients with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use thinletter/bge-m3-query-clients with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf thinletter/bge-m3-query-clients:Q4_0 # Run inference directly in the terminal: llama cli -hf thinletter/bge-m3-query-clients:Q4_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf thinletter/bge-m3-query-clients:Q4_0 # Run inference directly in the terminal: llama cli -hf thinletter/bge-m3-query-clients:Q4_0
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf thinletter/bge-m3-query-clients:Q4_0 # Run inference directly in the terminal: ./llama-cli -hf thinletter/bge-m3-query-clients:Q4_0
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf thinletter/bge-m3-query-clients:Q4_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf thinletter/bge-m3-query-clients:Q4_0
Use Docker
docker model run hf.co/thinletter/bge-m3-query-clients:Q4_0
- LM Studio
- Jan
- Ollama
How to use thinletter/bge-m3-query-clients with Ollama:
ollama run hf.co/thinletter/bge-m3-query-clients:Q4_0
- Unsloth Desktop
- Docker Model Runner
How to use thinletter/bge-m3-query-clients with Docker Model Runner:
docker model run hf.co/thinletter/bge-m3-query-clients:Q4_0
- Lemonade
How to use thinletter/bge-m3-query-clients with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull thinletter/bge-m3-query-clients:Q4_0
Run and chat with the model
lemonade run user.bge-m3-query-clients-Q4_0
List all available models
lemonade list
- Atomic Chat
bge-m3 query-side clients at 3–4 bits, calibrated on Czech text — summary and links
Two GGUF query encoders for bge-m3 dense retrieval (355 and 321 MiB instead of 1 104 MiB fp16), compatible with document vectors from the unchanged model (CLS pooling, 1024-d). On the model's own fp32 index of 55 071 Czech supreme-court segments the Q4_K_M file keeps 99.2 % of nDCG@10 (cosine 0.990, top-10 overlap 0.864) and the Q3_K file 98.3 % (cosine 0.970); the same Czech-calibrated files keep 99.6 / 100.0 % on SciFact, so the calibration language does not cost English.
Along the way: of the four families we measured on this index, the CLS-pooled XLM-R encoder tolerates quantization best (bge-m3 ≥ jina-v5-small > Qwen3-Embedding-0.6B, whose 3-bit files fail); the 250 002 × 1024 token table is half the file and its 4-bit version costs ≤ 0.2 points here, against 1.0 on Qwen3-Embedding. llama-imatrix refuses encoders that append EOS; the recipe on the card shows the one-line workaround.
- verify against your own index: https://github.com/rosecky/embedding-quantization-public
- report (§3.2, Czech case study): https://github.com/rosecky/embedding-quantization-public/blob/main/docs/release/technical_report.md
- the tables: https://github.com/rosecky/embedding-quantization-public/blob/main/results/tables/release2.md
Limits: synthetic Czech queries (doc2query, relevant = source segment), one English corpus; nothing here is a claim about the base model's quality. Questions and attacks welcome here.