granite embedding small english r2

提供商ibm-granite
分类feature-extraction
许可证apache-2.0
下载量138
星标0

简介

Granite Embedding Small English R2 是 IBM 推出的轻量级英文文本向量化模型。它专注于将文本高效转化为高维向量,是构建 RAG(检索增强生成)系统的核心组件。相比于大型模型,它在保持高性能检索的同时,显著降低了推理延迟和存储成本。对于中国开发者而言,该模型非常适合用于英文文档的语义搜索、知识库索引以及文本聚类分析。由于采用 Apache-2.0 协议,企业级部署非常灵活,上手难度极低,可直接替代 OpenAI 的 text-embedding-3-small 等闭源方案以实现私有化部署。

核心亮点

  • 专为 RAG 检索优化,大幅提升英文知识库召回率
  • 轻量化设计,推理速度快且内存占用极低
  • Apache-2.0 协议,支持企业级私有化部署
  • 语义表征能力强,适用于文档聚类与相似度计算

使用方法

安装依赖
# 安装 Hugging Face transformers
pip install transformers torch
SDK 使用
# 使用 transformers 加载模型
from transformers import AutoModel, AutoTokenizer

model = AutoModel.from_pretrained("ibm-granite/granite-embedding-small-english-r2")
tokenizer = AutoTokenizer.from_pretrained("ibm-granite/granite-embedding-small-english-r2")

Hugging Face 下载

我们推荐使用命令行或者 Hugging Face Hub SDK 来进行模型的下载。

操作指引:在下载前,请先通过如下命令安装 huggingface_hub:

操作指引
pip install -U huggingface_hub

命令行下载

下载完整模型库

下载完整模型库
huggingface-cli download ibm-granite/granite-embedding-small-english-r2

下载单个文件到指定本地文件夹(以下载 config.json 到当前路径下 ./dir 目录为例)

下载单个文件到指定本地文件夹(以下载 config.json 到当前路径下 ./dir 目录为例)
huggingface-cli download ibm-granite/granite-embedding-small-english-r2 config.json --local-dir ./dir

更多命令行下载选项,可参见官方文档

SDK 下载

SDK 下载
# 模型下载
from huggingface_hub import snapshot_download
model_dir = snapshot_download('ibm-granite/granite-embedding-small-english-r2')

Git 下载

请确保 lfs 已经被正确安装

Git 下载
git lfs install
git clone https://huggingface.co/ibm-granite/granite-embedding-small-english-r2

如果您希望跳过 lfs 大文件下载,可以使用如下命令

跳过 LFS
GIT_LFS_SKIP_SMUDGE=1 git clone https://huggingface.co/ibm-granite/granite-embedding-small-english-r2

模型文件托管在 Hugging Face Hub,使用 HF CLI / SDK / Git 直接下载,不经过本站。

PyTorch / Transformers 使用

安装 Transformers

安装 Transformers
pip install -U transformers torch

模型加载和推理

模型加载和推理
from transformers import AutoModelForCausalLM, AutoTokenizer

model = AutoModelForCausalLM.from_pretrained('ibm-granite/granite-embedding-small-english-r2')
tokenizer = AutoTokenizer.from_pretrained('ibm-granite/granite-embedding-small-english-r2')

模型下载

我们推荐使用命令行或者 ModelScope SDK 来进行模型的下载。

操作指引:在下载前,请先通过如下命令安装 ModelScope:

操作指引
pip install modelscope

命令行下载

下载完整模型库

下载完整模型库
modelscope download --model ibm-granite/granite-embedding-small-english-r2

下载单个文件到指定本地文件夹(以下载 README.md 到当前路径下 dir 目录为例)

下载单个文件到指定本地文件夹(以下载 README.md 到当前路径下 dir 目录为例)
modelscope download --model ibm-granite/granite-embedding-small-english-r2 README.md --local_dir ./dir

更多更丰富的命令行下载选项,可参见具体文档

SDK 下载

SDK 下载
# 模型下载
from modelscope import snapshot_download
model_dir = snapshot_download('ibm-granite/granite-embedding-small-english-r2')

Git 下载

请确保 lfs 已经被正确安装

Git 下载
git lfs install
git clone https://www.modelscope.cn/ibm-granite/granite-embedding-small-english-r2.git

如果您希望跳过 lfs 大文件下载,可以使用如下命令

跳过 LFS
GIT_LFS_SKIP_SMUDGE=1 git clone https://www.modelscope.cn/ibm-granite/granite-embedding-small-english-r2.git

ModelScope 模型页直接下载模型文件;无需将模型文件放在本站服务器。

Notebook 快速开发

下载并安装 ModelScope library

下载并安装 ModelScope library
pip install "modelscope[audio,cv,nlp,multi-modal,science]" -f https://modelscope.oss-cn-beijing.aliyuncs.com/releases/repo.html

模型加载和推理

模型加载和推理
from modelscope.pipelines import pipeline
from modelscope.utils.constant import Tasks

p = pipeline('text-generation', 'ibm-granite/granite-embedding-small-english-r2')

完整文档

来源: HuggingFace

---
language:

  • en

library_name: sentence-transformers
license: apache-2.0
pipeline_tag: feature-extraction
tags:
  • granite

  • embeddings

  • transformers

  • mteb

  • feature-extraction

---

Granite-Embedding-Small-English-R2

<!-- Provide a quick summary of what the model is/does. -->

Model Summary: Granite-embedding-small-english-r2 is a 47M parameter dense biencoder embedding model from the Granite Embeddings collection that can be used to generate high quality text embeddings. This model produces embedding vectors of size 384 based on context length of upto 8192 tokens. Compared to most other open-source models, this model was only trained using open-source relevance-pair datasets with permissive, enterprise-friendly license, plus IBM collected and generated datasets.

The r2 models show strong performance across standard and IBM-built information retrieval benchmarks (BEIR, ClapNQ),
code retrieval (COIR), long-document search benchmarks (MLDR, LongEmbed), conversational multi-turn (MTRAG),
table retrieval (NQTables, OTT-QA, AIT-QA, MultiHierTT, OpenWikiTables), and on many enterprise use cases.

These models use a bi-encoder architecture to generate high-quality embeddings from text inputs such as queries, passages, and documents, enabling seamless comparison through cosine similarity. Built using retrieval oriented pretraining, contrastive finetuning, knowledge distillation, and model merging, granite-embedding-small-english-r2 is optimized to ensure strong alignment between query and passage embeddings.

The latest granite embedding r2 release introduces two English embedding models, both based on the ModernBERT architecture:

  • _granite-embedding-english-r2_ (149M parameters): with an output embedding size of _768_, replacing _granite-embedding-125m-english_.

  • _granite-embedding-small-english-r2_ (47M parameters): A _first-of-its-kind_ reduced-size model, with 8192 context length support, fewer layers and a smaller output embedding size (_384_), replacing _granite-embedding-30m-english_.

Model Details

  • Developed by: Granite Embedding Team, IBM
  • Language(s): English
  • Release Date: Aug 15, 2025

Usage

Intended Use: The model is designed to produce fixed length vector representations for a given text, which can be used for text similarity, retrieval, and search applications.

For efficient decoding, these models use Flash Attention 2. Installing it is optional, but can lead to faster inference.

shell
pip install flash_attn==2.6.1

<!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->

Usage with Sentence Transformers:

The model is compatible with SentenceTransformer library and is very easy to use:

First, install the sentence transformers library

shell
pip install sentence_transformers

The model can then be used to encode pairs of text and find the similarity between their representations

python
from sentence_transformers import SentenceTransformer, util

model_path = "ibm-granite/granite-embedding-small-english-r2"

Load the Sentence Transformer model


model = SentenceTransformer(model_path)

input_queries = [
' Who made the song My achy breaky heart? ',
'summit define'
]

input_passages = [
"Achy Breaky Heart is a country song written by Don Von Tress. Originally titled Don't Tell My Heart and performed by The Marcy Brothers in 1991. ",
"Definition of summit for English Language Learners. : 1 the highest point of a mountain : the top of a mountain. : 2 the highest level. : 3 a meeting or series of meetings between the leaders of two or more governments."
]

encode queries and passages. The model produces unnormalized vectors. If your task requires normalized embeddings pass normalize_embeddings=True to encode as below.

query_embeddings = model.encode(input_queries) passage_embeddings = model.encode(input_passages)

calculate cosine similarity

print(util.cos_sim(query_embeddings, passage_embeddings))

Usage with Huggingface Transformers:

This is a simple example of how to use the granite-embedding-small-english-r2 model with the Transformers library and PyTorch.

First, install the required libraries

shell
pip install transformers torch

The model can then be used to encode pairs of text

python
import torch
from transformers import AutoModel, AutoTokenizer

model_path = "ibm-granite/granite-embedding-small-english-r2"

Load the model and tokenizer

model = AutoModel.from_pretrained(model_path) tokenizer = AutoTokenizer.from_pretrained(model_path) model.eval()

input_queries = [
' Who made the song My achy breaky heart? ',
'summit define'
]

tokenize inputs

tokenized_queries = tokenizer(input_queries, padding=True, truncation=True, return_tensors='pt')

encode queries

with torch.no_grad(): # Queries model_output = model(tokenized_queries) # Perform pooling. granite-embedding-278m-multilingual uses CLS Pooling query_embeddings = model_output[0][:, 0]

normalize the embeddings

query_embeddings = torch.nn.functional.normalize(query_embeddings, dim=1)

Evaluation Results

Granite embedding r2 models show a strong performance across tasks diverse tasks.

Performance of the granite models on MTEB Retrieval (i.e., BEIR), MTEB-v2, code retrieval (CoIR), long-document search benchmarks (MLDR, LongEmbed), conversational multi-turn (MTRAG),
table retrieval (NQTables, OTT-QA, AIT-QA, MultiHierTT, OpenWikiTables), benchmarks is reported in the below tables.

The average speed to encode documents on a single H100 GPU using a sliding window with 512 context length chunks is also reported.
Nearing encoding speed of 200 documents per second granite-embedding-small-english-r2 demonstrates speed and efficiency, while mainintaining competitive performance.

| Model | Parameters (M) | Embedding Size | BEIR Retrieval (15) | MTEB-v2 (41)| CoIR (10) | MLDR (En) | MTRAG (4) | Encoding Speed (dosc/sec) |
|------------------------------------|:--------------:|:--------------:|:-------------------:|:-----------:|:---------:|:---------:|:---------:|:-------------------------------:|
| granite-embedding-125m-english | 125 | 768 | 52.3 | 62.1 | 50.3 | 35.0 | 49.4 | 149 |
| granite-embedding-30m-english | 30 | 384 | 49.1 | 60.2 | 47.0 | 32.6 | 48.6 | 198 |
| granite-embedding-english-r2 | 149 | 768 | 53.1 | 62.8 | 55.3 | 40.7 | 56.7 | 144 |
| granite-embedding-small-english-r2 | 47 | 384 | 50.9 | 61.1 | 53.8 | 39.8 | 48.1 | 199 |

|Model | Parameters (M)| Embedding Size|AVERAGE**|MTEB-v2 Retrieval (10)| CoIR (10)| MLDR (En)| LongEmbed (6)| Table IR (5)| MTRAG (4) | Encoding Speed (docs/sec)|
|-----------------------------------|:-------------:|:-------------:|:---------:|:--------------------:|:--------:|:--------:|:------------:|:-----------:|:--------:|-----------:|
|e5-small-v2 |33|384|45.39|48.5|47.1|29.9|40.7|72.31|33.8| 138|
|bge-small-en-v1.5 |33|384|45.22|53.9|45.8|31.4|32.1|69.91|38.2| 138|
|||||||||||
|granite-embedding-english-r2 |149|768|59.5|56.4|54.8|41.6|67.8|78.53|57.6| 144|
|granite-embedding-small-english-r2 | 47|384|55.6|53.