Instructions to use jinaai/jina-embeddings-v5-text-small-clustering with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- sentence-transformers
How to use jinaai/jina-embeddings-v5-text-small-clustering with sentence-transformers:
from sentence_transformers import SentenceTransformer model = SentenceTransformer("jinaai/jina-embeddings-v5-text-small-clustering") sentences = [ "The weather is lovely today.", "It's so sunny outside!", "He drove to the stadium." ] embeddings = model.encode(sentences) similarities = model.similarity(embeddings, embeddings) print(similarities.shape) # [3, 3] - llama-cpp-python
How to use jinaai/jina-embeddings-v5-text-small-clustering with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="jinaai/jina-embeddings-v5-text-small-clustering", filename="v5-small-clustering-F16.gguf", )
llm.create_chat_completion( messages = "\"Today is a sunny day and I will get some ice cream.\"" )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use jinaai/jina-embeddings-v5-text-small-clustering 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 jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M # Run inference directly in the terminal: llama cli -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M # Run inference directly in the terminal: llama cli -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
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 jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
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 jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Use Docker
docker model run hf.co/jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use jinaai/jina-embeddings-v5-text-small-clustering with Ollama:
ollama run hf.co/jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
- Unsloth Studio
How to use jinaai/jina-embeddings-v5-text-small-clustering with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for jinaai/jina-embeddings-v5-text-small-clustering to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for jinaai/jina-embeddings-v5-text-small-clustering to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for jinaai/jina-embeddings-v5-text-small-clustering to start chatting
- Pi
How to use jinaai/jina-embeddings-v5-text-small-clustering with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use jinaai/jina-embeddings-v5-text-small-clustering with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use jinaai/jina-embeddings-v5-text-small-clustering with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use jinaai/jina-embeddings-v5-text-small-clustering with Docker Model Runner:
docker model run hf.co/jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
- Lemonade
How to use jinaai/jina-embeddings-v5-text-small-clustering with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull jinaai/jina-embeddings-v5-text-small-clustering:Q4_K_M
Run and chat with the model
lemonade run user.jina-embeddings-v5-text-small-clustering-Q4_K_M
List all available models
lemonade list
Create README.md
Browse files|
@@ -0,0 +1,92 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
base_model:
|
| 3 |
+
- Qwen/Qwen3-0.6B
|
| 4 |
+
license: cc
|
| 5 |
+
---
|
| 6 |
+
<br><br>
|
| 7 |
+
|
| 8 |
+
<p align="center">
|
| 9 |
+
<img src="https://huggingface.co/datasets/jinaai/documentation-images/resolve/main/logo.webp" alt="Jina AI: Your Search Foundation, Supercharged!" width="150px">
|
| 10 |
+
</p>
|
| 11 |
+
|
| 12 |
+
### **jina-embeddings-v5-text-small-clustering**: Clustering-Targeted Embedding Distillation
|
| 13 |
+
|
| 14 |
+
[Blog](https://picsum.photos/200/300) | [Technical Report](https://picsum.photos/200/300) | [API](https://jina.ai/embeddings)
|
| 15 |
+
|
| 16 |
+
### Model Overview
|
| 17 |
+
|
| 18 |
+
`jina-embeddings-v5-text-small-clustering` is a compact, high-performance text embedding model designed for clustering.
|
| 19 |
+
|
| 20 |
+
It is part of the **jina-embeddings-v5-text** model family, which also includes [jina-embeddings-v5-text-nano](https://huggingface.co/jinaai/jina-embeddings-v5-text-nano), a smaller model for more resource-constrained use cases.
|
| 21 |
+
|
| 22 |
+
Trained using a novel approach that combines distillation with task-specific contrastive losses, `jina-embeddings-v5-text-small-clustering` outperforms existing state-of-the-art models of similar size across diverse embedding benchmarks.
|
| 23 |
+
|
| 24 |
+
| Feature | Value |
|
| 25 |
+
| --- | --- |
|
| 26 |
+
| Parameters | 677M |
|
| 27 |
+
| Supported Tasks | `clustering`|
|
| 28 |
+
| Max Sequence Length | 32768 |
|
| 29 |
+
| Embedding Dimension | 1024 |
|
| 30 |
+
| Matryoshka Dimensions | 32, 64, 128, 256, 512, 768, 1024 |
|
| 31 |
+
| Pooling Strategy | Last-token pooling |
|
| 32 |
+
| Base Model | Qwen/Qwen3-0.6B-Base |
|
| 33 |
+
|
| 34 |
+
### Training and Evaluation
|
| 35 |
+
|
| 36 |
+
For training details and evaluation results, see our [technical report](https://picsum.photos/200/300).
|
| 37 |
+
|
| 38 |
+
### Usage
|
| 39 |
+
|
| 40 |
+
<details>
|
| 41 |
+
<summary>Requirements</a></summary>
|
| 42 |
+
|
| 43 |
+
The following Python packages are required:
|
| 44 |
+
|
| 45 |
+
- `transformers>=4.57.0`
|
| 46 |
+
- `torch>=2.8.0`
|
| 47 |
+
- `peft>=0.15.2`
|
| 48 |
+
|
| 49 |
+
### Optional / Recommended
|
| 50 |
+
- **flash-attention**: Installing [flash-attention](https://github.com/Dao-AILab/flash-attention) is recommended for improved inference speed and efficiency, but not mandatory.
|
| 51 |
+
- **sentence-transformers**: If you want to use the model via the `sentence-transformers` interface, install this package as well.
|
| 52 |
+
|
| 53 |
+
</details>
|
| 54 |
+
|
| 55 |
+
<details>
|
| 56 |
+
<summary>via <a href="https://github.com/vllm-project/vllm">vLLM</a></summary>
|
| 57 |
+
|
| 58 |
+
```python
|
| 59 |
+
from vllm import LLM
|
| 60 |
+
|
| 61 |
+
# Initialize model
|
| 62 |
+
name = "jinaai/jina-embeddings-v5-text-small-clustering"
|
| 63 |
+
model = LLM(model=name, task="embed", dtype="bfloat16")
|
| 64 |
+
|
| 65 |
+
# Create text prompts
|
| 66 |
+
document1 = "Overview of climate change impacts on coastal cities"
|
| 67 |
+
document1_prompt = f"Document: {document1}"
|
| 68 |
+
|
| 69 |
+
document2 = "The impacts of climate change on large cities"
|
| 70 |
+
document2_prompt = f"Document: {document2}"
|
| 71 |
+
|
| 72 |
+
# Encode all prompts
|
| 73 |
+
prompts = [document1_prompt, document2_prompt]
|
| 74 |
+
outputs = model.encode(prompts, pooling_task="embed")
|
| 75 |
+
|
| 76 |
+
|
| 77 |
+
embed_document1 = outputs[0].outputs.data
|
| 78 |
+
embed_document2 = outputs[1].outputs.data
|
| 79 |
+
```
|
| 80 |
+
|
| 81 |
+
</details>
|
| 82 |
+
|
| 83 |
+
### License
|
| 84 |
+
|
| 85 |
+
The model is licensed under CC BY-NC 4.0. For commercial use, please [contact us](link).
|
| 86 |
+
|
| 87 |
+
|
| 88 |
+
### Citation
|
| 89 |
+
|
| 90 |
+
If you find `jina-embeddings-v5-text-small-clustering` useful in your research, please cite the following paper:
|
| 91 |
+
|
| 92 |
+
[TODO]
|