update
Browse files
README.md
CHANGED
@@ -1,696 +1,12 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
|
2 |
|
3 |
-
|
4 |
-
<p align="center">
|
5 |
-
<a href="https://github.com/FlagOpen/FlagEmbedding">
|
6 |
-
<img alt="Build" src="https://img.shields.io/badge/Contribution-Welcome-blue">
|
7 |
-
</a>
|
8 |
-
<a href="https://github.com/FlagOpen/FlagEmbedding/blob/master/LICENSE">
|
9 |
-
<img alt="License" src="https://img.shields.io/badge/LICENSE-MIT-green">
|
10 |
-
</a>
|
11 |
-
<a href="https://huggingface.co/C-MTEB">
|
12 |
-
<img alt="Build" src="https://img.shields.io/badge/C_MTEB-🤗-yellow">
|
13 |
-
</a>
|
14 |
-
<a href="https://github.com/FlagOpen/FlagEmbedding/tree/master/FlagEmbedding/baai_general_embedding">
|
15 |
-
<img alt="Build" src="https://img.shields.io/badge/FlagEmbedding-1.0-red">
|
16 |
-
</a>
|
17 |
-
</p>
|
18 |
-
|
19 |
-
<h4 align="center">
|
20 |
-
<p>
|
21 |
-
<a href=#model-list>Model List</a> |
|
22 |
-
<a href=#frequently-asked-questions>FAQ</a> |
|
23 |
-
<a href=#usage>Usage</a> |
|
24 |
-
<a href="#evaluation">Evaluation</a> |
|
25 |
-
<a href="#train">Train</a> |
|
26 |
-
<a href="#contact">Contact</a> |
|
27 |
-
<a href="#license">License</a>
|
28 |
-
<p>
|
29 |
-
</h4>
|
30 |
-
|
31 |
-
|
32 |
-
[English](README.md) | [中文](https://github.com/FlagOpen/FlagEmbedding/blob/master/README_zh.md)
|
33 |
-
|
34 |
-
FlagEmbedding can map any text to a low-dimensional dense vector which can be used for tasks like retrieval, classification, clustering, or semantic search.
|
35 |
-
And it also can be used in vector database for LLMs.
|
36 |
-
|
37 |
-
************* 🌟**Updates**🌟 *************
|
38 |
-
- 08/09/2023: BGE Models are integrated into **Langchain**, you can use it like [this](#using-langchain); C-MTEB **leaderboard** is [avaliable](https://huggingface.co/spaces/mteb/leaderboard).
|
39 |
-
- 08/05/2023: Release base-scale and small-scale models, **best performance among the models of the same size 🤗**
|
40 |
-
- 08/02/2023: Release `bge-large-*`(short for BAAI General Embedding) Models, **rank 1st on MTEB and C-MTEB benchmark!** :tada: :tada:
|
41 |
-
- 08/01/2023: We release the [Chinese Massive Text Embedding Benchmark](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB) (**C-MTEB**), consisting of 31 test dataset.
|
42 |
-
|
43 |
-
|
44 |
-
## Model List
|
45 |
-
|
46 |
-
`bge` is short for `BAAI general embedding`.
|
47 |
-
|
48 |
-
| Model | Language | Description | query instruction for retrieval\* |
|
49 |
-
|:-------------------------------|:--------:| :--------:| :--------:|
|
50 |
-
| [BAAI/bge-large-en](https://huggingface.co/BAAI/bge-large-en) | English | :trophy: rank **1st** in [MTEB](https://huggingface.co/spaces/mteb/leaderboard) leaderboard | `Represent this sentence for searching relevant passages: ` |
|
51 |
-
| [BAAI/bge-base-en](https://huggingface.co/BAAI/bge-base-en) | English | rank **2nd** in [MTEB](https://huggingface.co/spaces/mteb/leaderboard) leaderboard | `Represent this sentence for searching relevant passages: ` |
|
52 |
-
| [BAAI/bge-small-en](https://huggingface.co/BAAI/bge-small-en) | English | a small-scale model but with competitive performance | `Represent this sentence for searching relevant passages: ` |
|
53 |
-
| [BAAI/bge-large-zh](https://huggingface.co/BAAI/bge-large-zh) | Chinese | :trophy: rank **1st** in [C-MTEB](https://github.com/FlagOpen/FlagEmbedding/tree/master/C_MTEB) benchmark | `为这个句子生成表示以用于检索相关文章:` |
|
54 |
-
| [BAAI/bge-large-zh-noinstruct](https://huggingface.co/BAAI/bge-large-zh-noinstruct) | Chinese | This model is trained without instruction, and rank **2nd** in [C-MTEB](https://github.com/FlagOpen/FlagEmbedding/tree/master/C_MTEB) benchmark | |
|
55 |
-
| [BAAI/bge-base-zh](https://huggingface.co/BAAI/bge-base-zh) | Chinese | a base-scale model but has similar ability with `bge-large-zh` | `为这个句子生成表示以用于检索相关文章:` |
|
56 |
-
| [BAAI/bge-small-zh](https://huggingface.co/BAAI/bge-small-zh) | Chinese | a small-scale model but with competitive performance | `为这个句子生成表示以用于检索相关文章:` |
|
57 |
-
|
58 |
-
\*: If you need to search the **long** relevant passages to a **short** query (s2p retrieval task), you need to add the instruction to the query; in other cases, no instruction is needed, just use the original query directly. In all cases, **no instruction** need to be added to passages.
|
59 |
-
|
60 |
-
## Frequently asked questions
|
61 |
-
|
62 |
-
1. The similarity score between two dissimilar sentence is higher than 0.5
|
63 |
-
|
64 |
-
The similarity distribution of the current BGE model is about in the interval \[0.6, 1\].
|
65 |
-
So a similarity score greater than 0.5 does not indicate that the two sentence are similar.
|
66 |
-
|
67 |
-
For downstream tasks, such as passage retrieval or semantic similarity,
|
68 |
-
**what matters is the relative order of the scores, not the absolute value.**
|
69 |
-
If you need to filter similar sentences based on a similarity threshold,
|
70 |
-
please select an appropriate similarity threshold based on the similarity distribution on your data (such as 0.8, 0.85, or even 0.9).
|
71 |
-
|
72 |
-
|
73 |
-
2. When do the query instruction need to be used
|
74 |
-
|
75 |
-
For a retrieval task that uses short queries to find long related documents,
|
76 |
-
it is recommended to add instructions for these short queries.
|
77 |
-
For other tasks, it is recommended not to add instructions.
|
78 |
-
For example, in Quora task, which needs to use a short question to search another related short questions,
|
79 |
-
the instruction is not recommended to add.
|
80 |
-
The best method to decide whether to add instructions for queries is choosing the setting which can achieve better performance in your task.
|
81 |
-
In all cases, the documents/passages do not need to add the instruction, only need to consider whether to add the instruction for queries.
|
82 |
-
|
83 |
-
|
84 |
-
|
85 |
-
|
86 |
-
## Usage
|
87 |
-
|
88 |
-
Here are some examples to use `bge` models with
|
89 |
-
[FlagEmbedding](#using-flagembedding), [Sentence-Transformers](#using-sentence-transformers), [Langchain](#using-langchain), or [Huggingface Transformers](#using-huggingface-transformers).
|
90 |
-
|
91 |
-
#### Using FlagEmbedding
|
92 |
-
```
|
93 |
-
pip install -U FlagEmbedding
|
94 |
-
```
|
95 |
-
If it doesn't work for you, you can see [FlagEmbedding](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md) for more methods to install FlagEmbedding.
|
96 |
-
|
97 |
-
```python
|
98 |
-
from FlagEmbedding import FlagModel
|
99 |
-
sentences_1 = ["样例数据-1", "样例数据-2"]
|
100 |
-
sentences_2 = ["样例数据-3", "样例数据-4"]
|
101 |
-
model = FlagModel('BAAI/bge-large-zh', query_instruction_for_retrieval="为这个句子生成表示以用于检索相关文章:")
|
102 |
-
embeddings_1 = model.encode(sentences_1)
|
103 |
-
embeddings_2 = model.encode(sentences_2)
|
104 |
-
similarity = embeddings_1 @ embeddings_2.T
|
105 |
-
print(similarity)
|
106 |
-
|
107 |
-
# for s2p(short query to long passage) retrieval task, please use encode_queries() which will automatically add the instruction to each query
|
108 |
-
# corpus in retrieval task can still use encode() or encode_corpus(), since they don't need instruction
|
109 |
-
queries = ['query_1', 'query_2']
|
110 |
-
passages = ["样例文档-1", "样例文档-2"]
|
111 |
-
q_embeddings = model.encode_queries(queries)
|
112 |
-
p_embeddings = model.encode(passages)
|
113 |
-
scores = q_embeddings @ p_embeddings.T
|
114 |
-
```
|
115 |
-
The value of argument `query_instruction_for_retrieval` see [Model List](https://github.com/FlagOpen/FlagEmbedding/tree/master#model-list).
|
116 |
-
|
117 |
-
FlagModel will use all available GPUs when encoding, please set `os.environ["CUDA_VISIBLE_DEVICES"]` to choose GPU.
|
118 |
-
You also can set `os.environ["CUDA_VISIBLE_DEVICES"]=""` to make GPUs unavailable.
|
119 |
-
|
120 |
-
|
121 |
-
#### Using Sentence-Transformers
|
122 |
-
|
123 |
-
Using this model also is easy when you have [sentence-transformers](https://www.SBERT.net) installed:
|
124 |
-
|
125 |
-
```
|
126 |
-
pip install -U sentence-transformers
|
127 |
-
```
|
128 |
-
```python
|
129 |
-
from sentence_transformers import SentenceTransformer
|
130 |
-
sentences_1 = ["样例数据-1", "样例数据-2"]
|
131 |
-
sentences_2 = ["样例数据-3", "样例数据-4"]
|
132 |
-
model = SentenceTransformer('BAAI/bge-large-zh')
|
133 |
-
embeddings_1 = model.encode(sentences_1, normalize_embeddings=True)
|
134 |
-
embeddings_2 = model.encode(sentences_2, normalize_embeddings=True)
|
135 |
-
similarity = embeddings_1 @ embeddings_2.T
|
136 |
-
print(similarity)
|
137 |
-
```
|
138 |
-
For s2p(short query to long passage) retrieval task,
|
139 |
-
each short query should start with an instruction (instructions see [Model List](https://github.com/FlagOpen/FlagEmbedding/tree/master#model-list)).
|
140 |
-
But the instruction is not needed for passages.
|
141 |
-
```python
|
142 |
-
from sentence_transformers import SentenceTransformer
|
143 |
-
queries = ['query_1', 'query_2']
|
144 |
-
passages = ["样例文档-1", "样例文档-2"]
|
145 |
-
instruction = "为这个句子生成表示以用于检索相关文章:"
|
146 |
-
|
147 |
-
model = SentenceTransformer('BAAI/bge-large-zh')
|
148 |
-
q_embeddings = model.encode([instruction+q for q in queries], normalize_embeddings=True)
|
149 |
-
p_embeddings = model.encode(passages, normalize_embeddings=True)
|
150 |
-
scores = q_embeddings @ p_embeddings.T
|
151 |
-
```
|
152 |
-
|
153 |
-
#### Using Langchain
|
154 |
-
|
155 |
-
You can use `bge` in langchain like this:
|
156 |
-
```python
|
157 |
-
from langchain.embeddings import HuggingFaceBgeEmbeddings
|
158 |
-
model_name = "BAAI/bge-small-en"
|
159 |
-
model_kwargs = {'device': 'cuda'}
|
160 |
-
encode_kwargs = {'normalize_embeddings': True} # set True to compute cosine similarity
|
161 |
-
model = HuggingFaceBgeEmbeddings(
|
162 |
-
model_name=model_name,
|
163 |
-
model_kwargs=model_kwargs,
|
164 |
-
encode_kwargs=encode_kwargs,
|
165 |
-
query_instruction="为这个句子生成表示以用于检索相关文章:"
|
166 |
-
)
|
167 |
-
```
|
168 |
-
|
169 |
-
|
170 |
-
#### Using HuggingFace Transformers
|
171 |
-
|
172 |
-
With transformers package, you can use the model like this: First, you pass your input through the transformer model, then you select the last hidden state of first token (i.e., [CLS]) as the sentence embedding.
|
173 |
-
|
174 |
-
```python
|
175 |
-
from transformers import AutoTokenizer, AutoModel
|
176 |
-
import torch
|
177 |
-
# Sentences we want sentence embeddings for
|
178 |
-
sentences = ["样例数据-1", "样例数据-2"]
|
179 |
-
|
180 |
-
# Load model from HuggingFace Hub
|
181 |
-
tokenizer = AutoTokenizer.from_pretrained('BAAI/bge-large-zh')
|
182 |
-
model = AutoModel.from_pretrained('BAAI/bge-large-zh')
|
183 |
-
|
184 |
-
# Tokenize sentences
|
185 |
-
encoded_input = tokenizer(sentences, padding=True, truncation=True, return_tensors='pt')
|
186 |
-
# for s2p(short query to long passage) retrieval task, add an instruction to query (not add instruction for passages)
|
187 |
-
# encoded_input = tokenizer([instruction + q for q in queries], padding=True, truncation=True, return_tensors='pt')
|
188 |
-
|
189 |
-
# Compute token embeddings
|
190 |
-
with torch.no_grad():
|
191 |
-
model_output = model(**encoded_input)
|
192 |
-
# Perform pooling. In this case, cls pooling.
|
193 |
-
sentence_embeddings = model_output[0][:, 0]
|
194 |
-
# normalize embeddings
|
195 |
-
sentence_embeddings = torch.nn.functional.normalize(sentence_embeddings, p=2, dim=1)
|
196 |
-
print("Sentence embeddings:", sentence_embeddings)
|
197 |
-
```
|
198 |
-
|
199 |
-
|
200 |
-
## Evaluation
|
201 |
-
`baai-general-embedding` models achieve **state-of-the-art performance on both MTEB and C-MTEB leaderboard!**
|
202 |
-
More details and evaluation tools see our [scripts](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB/README.md).
|
203 |
-
|
204 |
-
- **MTEB**:
|
205 |
-
|
206 |
-
| Model Name | Dimension | Sequence Length | Average (56) | Retrieval (15) |Clustering (11) | Pair Classification (3) | Reranking (4) | STS (10) | Summarization (1) | Classification (12) |
|
207 |
-
|:----:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
208 |
-
| [**bge-large-en**](https://huggingface.co/BAAI/bge-large-en) | 1024 | 512 | **63.98** | **53.9** | **46.98** | 85.8 | **59.48** | 81.56 | 32.06 | **76.21** |
|
209 |
-
| [**bge-base-en**](https://huggingface.co/BAAI/bge-base-en) | 768 | 512 | 63.36 | 53.0 | 46.32 | 85.86 | 58.7 | 81.84 | 29.27 | 75.27 |
|
210 |
-
| [gte-large](https://huggingface.co/thenlper/gte-large) | 1024 | 512 | 63.13 | 52.22 | 46.84 | 85.00 | 59.13 | 83.35 | 31.66 | 73.33 |
|
211 |
-
| [gte-base](https://huggingface.co/thenlper/gte-base) | 768 | 512 | 62.39 | 51.14 | 46.2 | 84.57 | 58.61 | 82.3 | 31.17 | 73.01 |
|
212 |
-
| [e5-large-v2](https://huggingface.co/intfloat/e5-large-v2) | 1024| 512 | 62.25 | 50.56 | 44.49 | 86.03 | 56.61 | 82.05 | 30.19 | 75.24 |
|
213 |
-
| [**bge-small-en**](https://huggingface.co/BAAI/bge-small-en) | 384 | 512 | 62.11 | 51.82 | 44.31 | 83.78 | 57.97 | 80.72 | 30.53 | 74.37 |
|
214 |
-
| [instructor-xl](https://huggingface.co/hkunlp/instructor-xl) | 768 | 512 | 61.79 | 49.26 | 44.74 | 86.62 | 57.29 | 83.06 | 32.32 | 61.79 |
|
215 |
-
| [e5-base-v2](https://huggingface.co/intfloat/e5-base-v2) | 768 | 512 | 61.5 | 50.29 | 43.80 | 85.73 | 55.91 | 81.05 | 30.28 | 73.84 |
|
216 |
-
| [gte-small](https://huggingface.co/thenlper/gte-small) | 384 | 512 | 61.36 | 49.46 | 44.89 | 83.54 | 57.7 | 82.07 | 30.42 | 72.31 |
|
217 |
-
| [text-embedding-ada-002](https://platform.openai.com/docs/guides/embeddings) | 1536 | 8192 | 60.99 | 49.25 | 45.9 | 84.89 | 56.32 | 80.97 | 30.8 | 70.93 |
|
218 |
-
| [e5-small-v2](https://huggingface.co/intfloat/e5-base-v2) | 384 | 512 | 59.93 | 49.04 | 39.92 | 84.67 | 54.32 | 80.39 | 31.16 | 72.94 |
|
219 |
-
| [sentence-t5-xxl](https://huggingface.co/sentence-transformers/sentence-t5-xxl) | 768 | 512 | 59.51 | 42.24 | 43.72 | 85.06 | 56.42 | 82.63 | 30.08 | 73.42 |
|
220 |
-
| [all-mpnet-base-v2](https://huggingface.co/sentence-transformers/all-mpnet-base-v2) | 768 | 514 | 57.78 | 43.81 | 43.69 | 83.04 | 59.36 | 80.28 | 27.49 | 65.07 |
|
221 |
-
| [sgpt-bloom-7b1-msmarco](https://huggingface.co/bigscience/sgpt-bloom-7b1-msmarco) | 4096 | 2048 | 57.59 | 48.22 | 38.93 | 81.9 | 55.65 | 77.74 | 33.6 | 66.19 |
|
222 |
-
| [all-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/all-MiniLM-L12-v2) | 384 | 512 | 56.53 | 42.69 | 41.81 | 82.41 | 58.44 | 79.8 | 27.9 | 63.21 |
|
223 |
-
| [all-MiniLM-L6-v2](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) | 384 | 512 | 56.26 | 41.95 | 42.35 | 82.37 | 58.04 | 78.9 | 30.81 | 63.05 |
|
224 |
-
| [contriever-base-msmarco](https://huggingface.co/nthakur/contriever-base-msmarco) | 768 | 512 | 56.00 | 41.88 | 41.1 | 82.54 | 53.14 | 76.51 | 30.36 | 66.68 |
|
225 |
-
| [sentence-t5-base](https://huggingface.co/sentence-transformers/sentence-t5-base) | 768 | 512 | 55.27 | 33.63 | 40.21 | 85.18 | 53.09 | 81.14 | 31.39 | 69.81 |
|
226 |
-
|
227 |
-
|
228 |
-
|
229 |
-
- **C-MTEB**:
|
230 |
-
We create a benchmark C-MTEB for chinese text embedding which consists of 31 datasets from 6 tasks.
|
231 |
-
Please refer to [C_MTEB](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB/README.md) for a detailed introduction.
|
232 |
-
|
233 |
-
| Model | Embedding dimension | Avg | Retrieval | STS | PairClassification | Classification | Reranking | Clustering |
|
234 |
-
|:-------------------------------|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|
|
235 |
-
| [**bge-large-zh**](https://huggingface.co/BAAI/bge-large-zh) | 1024 | **64.20** | **71.53** | **53.23** | **78.94** | 72.26 | **65.11** | 48.39 |
|
236 |
-
| [**bge-large-zh-noinstruct**](https://huggingface.co/BAAI/bge-large-zh-noinstruct) | 1024 | 63.53 | 70.55 | 50.98 | 76.77 | **72.49** | 64.91 | **50.01** |
|
237 |
-
| [**BAAI/bge-base-zh**](https://huggingface.co/BAAI/bge-base-zh) | 768 | 62.96 | 69.53 | 52.05 | 77.5 | 70.98 | 64.91 | 47.63 |
|
238 |
-
| [**BAAI/bge-small-zh**](https://huggingface.co/BAAI/bge-small-zh) | 512 | 58.27 | 63.07 | 46.87 | 70.35 | 67.78 | 61.48 | 45.09 |
|
239 |
-
| [m3e-base](https://huggingface.co/moka-ai/m3e-base) | 768 | 57.10 |56.91 | 48.15 | 63.99 | 70.28 | 59.34 | 47.68 |
|
240 |
-
| [m3e-large](https://huggingface.co/moka-ai/m3e-large) | 1024 | 57.05 |54.75 | 48.64 | 64.3 | 71.22 | 59.66 | 48.88 |
|
241 |
-
| [text-embedding-ada-002(OpenAI)](https://platform.openai.com/docs/guides/embeddings/what-are-embeddings) | 1536 | 53.02 | 52.0 | 40.61 | 69.56 | 67.38 | 54.28 | 45.68 |
|
242 |
-
| [luotuo](https://huggingface.co/silk-road/luotuo-bert-medium) | 1024 | 49.37 | 44.4 | 39.41 | 66.62 | 65.29 | 49.25 | 44.39 |
|
243 |
-
| [text2vec](https://huggingface.co/shibing624/text2vec-base-chinese) | 768 | 47.63 | 38.79 | 41.71 | 67.41 | 65.18 | 49.45 | 37.66 |
|
244 |
-
| [text2vec-large](https://huggingface.co/GanymedeNil/text2vec-large-chinese) | 1024 | 47.36 | 41.94 | 41.98 | 70.86 | 63.42 | 49.16 | 30.02 |
|
245 |
-
|
246 |
-
|
247 |
-
|
248 |
-
## Train
|
249 |
-
This section will introduce the way we used to train the general embedding.
|
250 |
-
The training scripts are in [FlagEmbedding](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md),
|
251 |
-
and we provide some examples to do [pre-train](https://github.com/FlagOpen/FlagEmbedding/blob/master/examples/pretrain/README.md) and [fine-tune](https://github.com/FlagOpen/FlagEmbedding/blob/master/examples/finetune/README.md).
|
252 |
-
|
253 |
-
|
254 |
-
**1. RetroMAE Pre-train**
|
255 |
-
We pre-train the model following the method [retromae](https://github.com/staoxiao/RetroMAE),
|
256 |
-
which shows promising improvement in retrieval task ([paper](https://aclanthology.org/2022.emnlp-main.35.pdf)).
|
257 |
-
The pre-training was conducted on 24 A100(40G) GPUs with a batch size of 720.
|
258 |
-
In retromae, the mask ratio of encoder and decoder are 0.3, 0.5 respectively.
|
259 |
-
We used the AdamW optimizer and the learning rate is 2e-5.
|
260 |
-
|
261 |
-
**Pre-training data**:
|
262 |
-
- English:
|
263 |
-
- [Pile](https://pile.eleuther.ai/)
|
264 |
-
- [wikipedia](https://huggingface.co/datasets/wikipedia)
|
265 |
-
- [msmarco](https://huggingface.co/datasets/Tevatron/msmarco-passage-corpus)
|
266 |
-
- Chinese:
|
267 |
-
- [wudao](https://github.com/BAAI-WuDao/Data)
|
268 |
-
|
269 |
-
|
270 |
-
**2. Finetune**
|
271 |
-
We fine-tune the model using a contrastive objective.
|
272 |
-
The format of input data is a triple`(query, positive, negative)`.
|
273 |
-
Besides the negative in the triple, we also adopt in-batch negatives strategy.
|
274 |
-
We employ the cross-device negatives sharing method to share negatives among different GPUs,
|
275 |
-
which can dramatically **increase the number of negatives**.
|
276 |
-
|
277 |
-
We trained our model on 48 A100(40G) GPUs with a large batch size of 32,784 (so there are **65,567** negatives for each query in a batch).
|
278 |
-
We used the AdamW optimizer and the learning rate is 1e-5.
|
279 |
-
The temperature for contrastive loss is 0.01.
|
280 |
-
|
281 |
-
Besides, we add instruction to the query for s2p(short query to long passage) retrieval task in the training (add nothing to passages).
|
282 |
-
For English, the instruction is `Represent this sentence for searching relevant passages: `;
|
283 |
-
For Chinese, the instruction is `为这个句子生成表示以用于检索相关文章:`.
|
284 |
-
In the evaluation, the instruction should be added for queries in retrieval task, not be added for other tasks.
|
285 |
-
Noted that the instruction is not needed for passages.
|
286 |
-
|
287 |
-
The finetune script is accessible in this repository: [FlagEmbedding](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md).
|
288 |
-
You can easily finetune your model with it.
|
289 |
-
|
290 |
-
**Training data**:
|
291 |
-
|
292 |
-
- For English, we collect 230M text pairs from [wikipedia](https://huggingface.co/datasets/wikipedia), [cc-net](https://github.com/facebookresearch/cc_net), and so on.
|
293 |
-
|
294 |
-
- For chinese, we collect 120M text pairs from [wudao](https://github.com/BAAI-WuDao/Data), [simclue](https://github.com/CLUEbenchmark/SimCLUE), and so on.
|
295 |
-
|
296 |
-
**The data collection is to be released in the future.**
|
297 |
-
|
298 |
-
|
299 |
-
## Schedule
|
300 |
-
- [x] Chinese Massive Text Embedding Benchmark
|
301 |
-
- [x] release baai-general-embedding models
|
302 |
-
- [x] release codes for training
|
303 |
-
- [ ] Multilingual model
|
304 |
-
- [ ] Training Datasets
|
305 |
-
- [ ] ...
|
306 |
-
|
307 |
-
We will continually update the embedding models and training codes,
|
308 |
-
hoping to promote the development of the embedding model community.
|
309 |
-
|
310 |
-
|
311 |
-
## Contact
|
312 |
-
If you have any question or suggestion related to this project, feel free to open an issue or pull a request.
|
313 |
-
You also can email Shitao Xiao([email protected]) and Zheng Liu([email protected]).
|
314 |
-
|
315 |
-
|
316 |
-
## License
|
317 |
-
FlagEmbedding is licensed under [MIT License](https://github.com/FlagOpen/FlagEmbedding/blob/master/LICENSE). The released models can be used for commercial purposes free of charge.
|
318 |
-
|
319 |
-
|
320 |
-
|
321 |
-
|
322 |
-
|
323 |
-
<h1 align="center">FlagEmbedding</h1>
|
324 |
-
|
325 |
-
|
326 |
-
<h4 align="center">
|
327 |
-
<p>
|
328 |
-
<a href=#model-list>Model List</a> |
|
329 |
-
<a href=#usage>Usage</a> |
|
330 |
-
<a href="#evaluation">Evaluation</a> |
|
331 |
-
<a href="#train">Train</a> |
|
332 |
-
<a href="#contact">Contact</a> |
|
333 |
-
<a href="#license">License</a>
|
334 |
-
<p>
|
335 |
-
</h4>
|
336 |
-
|
337 |
-
More details please refer to our Github: [FlagEmbedding](https://github.com/FlagOpen/FlagEmbedding).
|
338 |
-
|
339 |
-
|
340 |
-
|
341 |
-
[English](README.md) | [中文](https://github.com/FlagOpen/FlagEmbedding/blob/master/README_zh.md)
|
342 |
-
|
343 |
-
FlagEmbedding can map any text to a low-dimensional dense vector which can be used for tasks like retrieval, classification, clustering, or semantic search.
|
344 |
-
And it also can be used in vector databases for LLMs.
|
345 |
-
|
346 |
-
************* 🌟**Updates**🌟 *************
|
347 |
-
- 09/12/2023: New Release:
|
348 |
-
- **New reranker model**: release a cross-encoder model bge-reranker-base, which is more powerful than embedding model. We recommend to use/fine-tune it to re-rank top-k documents returned by embedding models.
|
349 |
-
- **update embedding model**: release bge-*-v1.5 embedding model to alleviate the issue of the similarity distribution, and enhance its retrieval ability without instruction.
|
350 |
-
- 09/07/2023: Update [fine-tune code](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md): Add script to mine hard negatives and support adding instruction during fine-tuning.
|
351 |
-
- 08/09/2023: BGE Models are integrated into **Langchain**, you can use it like [this](#using-langchain); C-MTEB **leaderboard** is [available](https://huggingface.co/spaces/mteb/leaderboard).
|
352 |
-
- 08/05/2023: Release base-scale and small-scale models, **best performance among the models of the same size 🤗**
|
353 |
-
- 08/02/2023: Release `bge-large-*`(short for BAAI General Embedding) Models, **rank 1st on MTEB and C-MTEB benchmark!** :tada: :tada:
|
354 |
-
- 08/01/2023: We release the [Chinese Massive Text Embedding Benchmark](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB) (**C-MTEB**), consisting of 31 test dataset.
|
355 |
-
|
356 |
-
|
357 |
-
## Model List
|
358 |
-
|
359 |
-
`bge` is short for `BAAI general embedding`.
|
360 |
-
|
361 |
-
| Model | Language | | Description | query instruction for retrieval\* |
|
362 |
-
|:-------------------------------|:--------:| :--------:| :--------:|:--------:|
|
363 |
-
| [BAAI/bge-reranker-large](https://huggingface.co/BAAI/bge-reranker-large) | Chinese and English | [Inference](#usage-for-reranker) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/reranker) | a cross-encoder model which is more accurate but less efficient \** | |
|
364 |
-
| [BAAI/bge-reranker-base](https://huggingface.co/BAAI/bge-reranker-base) | Chinese and English | [Inference](#usage-for-reranker) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/reranker) | a cross-encoder model which is more accurate but less efficient \** | |
|
365 |
-
| [BAAI/bge-large-en-v1.5](https://huggingface.co/BAAI/bge-large-en-v1.5) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `Represent this sentence for searching relevant passages: ` |
|
366 |
-
| [BAAI/bge-base-en-v1.5](https://huggingface.co/BAAI/bge-base-en-v1.5) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `Represent this sentence for searching relevant passages: ` |
|
367 |
-
| [BAAI/bge-small-en-v1.5](https://huggingface.co/BAAI/bge-small-en-v1.5) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `Represent this sentence for searching relevant passages: ` |
|
368 |
-
| [BAAI/bge-large-zh-v1.5](https://huggingface.co/BAAI/bge-large-zh-v1.5) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `为这个句子生成表示以用于检索相关文章:` |
|
369 |
-
| [BAAI/bge-base-zh-v1.5](https://huggingface.co/BAAI/bge-base-zh-v1.5) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `为这个句子生成表示以用于检索相关文章:` |
|
370 |
-
| [BAAI/bge-small-zh-v1.5](https://huggingface.co/BAAI/bge-small-zh-v1.5) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | version 1.5 with more reasonable similarity distribution | `为这个句子生成表示以用于检索相关文章:` |
|
371 |
-
| [BAAI/bge-large-en](https://huggingface.co/BAAI/bge-large-en) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | :trophy: rank **1st** in [MTEB](https://huggingface.co/spaces/mteb/leaderboard) leaderboard | `Represent this sentence for searching relevant passages: ` |
|
372 |
-
| [BAAI/bge-base-en](https://huggingface.co/BAAI/bge-base-en) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | a base-scale model but with similar ability to `bge-large-en` | `Represent this sentence for searching relevant passages: ` |
|
373 |
-
| [BAAI/bge-small-en](https://huggingface.co/BAAI/bge-small-en) | English | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) |a small-scale model but with competitive performance | `Represent this sentence for searching relevant passages: ` |
|
374 |
-
| [BAAI/bge-large-zh](https://huggingface.co/BAAI/bge-large-zh) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | :trophy: rank **1st** in [C-MTEB](https://github.com/FlagOpen/FlagEmbedding/tree/master/C_MTEB) benchmark | `为这个句子生成表示以用于检索相关文章:` |
|
375 |
-
| [BAAI/bge-base-zh](https://huggingface.co/BAAI/bge-base-zh) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | a base-scale model but with similar ability to `bge-large-zh` | `为这个句子生成表示以用于检索相关文章:` |
|
376 |
-
| [BAAI/bge-small-zh](https://huggingface.co/BAAI/bge-small-zh) | Chinese | [Inference](#usage-for-embedding-model) [Fine-tune](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) | a small-scale model but with competitive performance | `为这个句子生成表示以用于检索相关文章:` |
|
377 |
-
|
378 |
-
|
379 |
-
\*: If you need to search the relevant passages to a query, we suggest to add the instruction to the query; in other cases, no instruction is needed, just use the original query directly. In all cases, **no instruction** needs to be added to passages.
|
380 |
-
|
381 |
-
\**: To balance the accuracy and time cost, cross-encoder is widely used to re-rank top-k documents retrieved by other simple models.
|
382 |
-
For examples, use bge embedding model to retrieve top 100 relevant documents, and then use bge reranker to re-rank the top 100 document to get the final top-3 results.
|
383 |
-
|
384 |
-
|
385 |
-
## Frequently asked questions
|
386 |
-
|
387 |
-
<details>
|
388 |
-
<summary>1. How to fine-tune bge embedding model?</summary>
|
389 |
-
|
390 |
-
<!-- ### How to fine-tune bge embedding model? -->
|
391 |
-
Following this [example](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune) to prepare data and fine-tune your model.
|
392 |
-
Some suggestions:
|
393 |
-
- Mine hard negatives following this [example](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune#data-format), which can improve the retrieval performance.
|
394 |
-
- If you pre-train bge on your data, the pre-trained model cannot be directly used to calculate similarity, and it must be fine-tuned with contrastive learning before computing similarity.
|
395 |
-
- If the accuracy of the fine-tuned model is still not high, it is recommended to use/fine-tune the cross-encoder model (bge-reranker) to re-rank top-k results. Hard negatives also are needed to fine-tune reranker.
|
396 |
-
|
397 |
-
|
398 |
-
</details>
|
399 |
-
|
400 |
-
<details>
|
401 |
-
<summary>2. The similarity score between two dissimilar sentences is higher than 0.5</summary>
|
402 |
-
|
403 |
-
<!-- ### The similarity score between two dissimilar sentences is higher than 0.5 -->
|
404 |
-
**Suggest to use bge v1.5, which alleviates the issue of the similarity distribution.**
|
405 |
-
|
406 |
-
Since we finetune the models by contrastive learning with a temperature of 0.01,
|
407 |
-
the similarity distribution of the current BGE model is about in the interval \[0.6, 1\].
|
408 |
-
So a similarity score greater than 0.5 does not indicate that the two sentences are similar.
|
409 |
-
|
410 |
-
For downstream tasks, such as passage retrieval or semantic similarity,
|
411 |
-
**what matters is the relative order of the scores, not the absolute value.**
|
412 |
-
If you need to filter similar sentences based on a similarity threshold,
|
413 |
-
please select an appropriate similarity threshold based on the similarity distribution on your data (such as 0.8, 0.85, or even 0.9).
|
414 |
-
|
415 |
-
</details>
|
416 |
-
|
417 |
-
<details>
|
418 |
-
<summary>3. When does the query instruction need to be used</summary>
|
419 |
-
|
420 |
-
<!-- ### When does the query instruction need to be used -->
|
421 |
-
|
422 |
-
For a retrieval task that uses short queries to find long related documents,
|
423 |
-
it is recommended to add instructions for these short queries.
|
424 |
-
**The best method to decide whether to add instructions for queries is choosing the setting that achieves better performance on your task.**
|
425 |
-
In all cases, the documents/passages do not need to add the instruction.
|
426 |
-
|
427 |
-
</details>
|
428 |
-
|
429 |
-
|
430 |
-
## Usage
|
431 |
-
|
432 |
-
### Usage for Embedding Model
|
433 |
-
|
434 |
-
Here are some examples for using `bge` models with
|
435 |
-
[FlagEmbedding](#using-flagembedding), [Sentence-Transformers](#using-sentence-transformers), [Langchain](#using-langchain), or [Huggingface Transformers](#using-huggingface-transformers).
|
436 |
-
|
437 |
-
#### Using FlagEmbedding
|
438 |
-
```
|
439 |
-
pip install -U FlagEmbedding
|
440 |
-
```
|
441 |
-
If it doesn't work for you, you can see [FlagEmbedding](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md) for more methods to install FlagEmbedding.
|
442 |
-
|
443 |
-
```python
|
444 |
-
from FlagEmbedding import FlagModel
|
445 |
-
sentences_1 = ["样例数据-1", "样例数据-2"]
|
446 |
-
sentences_2 = ["样例数据-3", "样例数据-4"]
|
447 |
-
model = FlagModel('BAAI/bge-large-zh', query_instruction_for_retrieval="为这个句子生成表示以用于检索相关文章:")
|
448 |
-
embeddings_1 = model.encode(sentences_1)
|
449 |
-
embeddings_2 = model.encode(sentences_2)
|
450 |
-
similarity = embeddings_1 @ embeddings_2.T
|
451 |
-
print(similarity)
|
452 |
-
|
453 |
-
# for s2p(short query to long passage) retrieval task, suggest to use encode_queries() which will automatically add the instruction to each query
|
454 |
-
# corpus in retrieval task can still use encode() or encode_corpus(), since they don't need instruction
|
455 |
-
queries = ['query_1', 'query_2']
|
456 |
-
passages = ["样例文档-1", "样例文档-2"]
|
457 |
-
q_embeddings = model.encode_queries(queries)
|
458 |
-
p_embeddings = model.encode(passages)
|
459 |
-
scores = q_embeddings @ p_embeddings.T
|
460 |
-
```
|
461 |
-
For the value of the argument `query_instruction_for_retrieval`, see [Model List](https://github.com/FlagOpen/FlagEmbedding/tree/master#model-list).
|
462 |
-
|
463 |
-
By default, FlagModel will use all available GPUs when encoding. Please set `os.environ["CUDA_VISIBLE_DEVICES"]` to select specific GPUs.
|
464 |
-
You also can set `os.environ["CUDA_VISIBLE_DEVICES"]=""` to make all GPUs unavailable.
|
465 |
-
|
466 |
-
|
467 |
-
#### Using Sentence-Transformers
|
468 |
-
|
469 |
-
You can also use the `bge` models with [sentence-transformers](https://www.SBERT.net):
|
470 |
-
|
471 |
-
```
|
472 |
-
pip install -U sentence-transformers
|
473 |
-
```
|
474 |
-
```python
|
475 |
-
from sentence_transformers import SentenceTransformer
|
476 |
-
sentences_1 = ["样例数据-1", "样例数据-2"]
|
477 |
-
sentences_2 = ["样例数据-3", "样例数据-4"]
|
478 |
-
model = SentenceTransformer('BAAI/bge-large-zh')
|
479 |
-
embeddings_1 = model.encode(sentences_1, normalize_embeddings=True)
|
480 |
-
embeddings_2 = model.encode(sentences_2, normalize_embeddings=True)
|
481 |
-
similarity = embeddings_1 @ embeddings_2.T
|
482 |
-
print(similarity)
|
483 |
-
```
|
484 |
-
For s2p(short query to long passage) retrieval task,
|
485 |
-
each short query should start with an instruction (instructions see [Model List](https://github.com/FlagOpen/FlagEmbedding/tree/master#model-list)).
|
486 |
-
But the instruction is not needed for passages.
|
487 |
-
```python
|
488 |
-
from sentence_transformers import SentenceTransformer
|
489 |
-
queries = ['query_1', 'query_2']
|
490 |
-
passages = ["样例文档-1", "样例文档-2"]
|
491 |
-
instruction = "为这个句子生成表示以用于检索相关文章:"
|
492 |
-
|
493 |
-
model = SentenceTransformer('BAAI/bge-large-zh')
|
494 |
-
q_embeddings = model.encode([instruction+q for q in queries], normalize_embeddings=True)
|
495 |
-
p_embeddings = model.encode(passages, normalize_embeddings=True)
|
496 |
-
scores = q_embeddings @ p_embeddings.T
|
497 |
-
```
|
498 |
-
|
499 |
-
#### Using Langchain
|
500 |
-
|
501 |
-
You can use `bge` in langchain like this:
|
502 |
-
```python
|
503 |
-
from langchain.embeddings import HuggingFaceBgeEmbeddings
|
504 |
-
model_name = "BAAI/bge-small-en"
|
505 |
-
model_kwargs = {'device': 'cuda'}
|
506 |
-
encode_kwargs = {'normalize_embeddings': True} # set True to compute cosine similarity
|
507 |
-
model = HuggingFaceBgeEmbeddings(
|
508 |
-
model_name=model_name,
|
509 |
-
model_kwargs=model_kwargs,
|
510 |
-
encode_kwargs=encode_kwargs,
|
511 |
-
query_instruction="为这个句子生成表示以用于检索相关文章:"
|
512 |
-
)
|
513 |
-
model.query_instruction = "为这个句子生成表示以用于检索相关文章:"
|
514 |
-
```
|
515 |
-
|
516 |
-
|
517 |
-
#### Using HuggingFace Transformers
|
518 |
-
|
519 |
-
With the transformers package, you can use the model like this: First, you pass your input through the transformer model, then you select the last hidden state of the first token (i.e., [CLS]) as the sentence embedding.
|
520 |
-
|
521 |
-
```python
|
522 |
-
from transformers import AutoTokenizer, AutoModel
|
523 |
-
import torch
|
524 |
-
# Sentences we want sentence embeddings for
|
525 |
-
sentences = ["样例数据-1", "样例数据-2"]
|
526 |
-
|
527 |
-
# Load model from HuggingFace Hub
|
528 |
-
tokenizer = AutoTokenizer.from_pretrained('BAAI/bge-large-zh')
|
529 |
-
model = AutoModel.from_pretrained('BAAI/bge-large-zh')
|
530 |
-
model.eval()
|
531 |
-
|
532 |
-
# Tokenize sentences
|
533 |
-
encoded_input = tokenizer(sentences, padding=True, truncation=True, return_tensors='pt')
|
534 |
-
# for s2p(short query to long passage) retrieval task, add an instruction to query (not add instruction for passages)
|
535 |
-
# encoded_input = tokenizer([instruction + q for q in queries], padding=True, truncation=True, return_tensors='pt')
|
536 |
-
|
537 |
-
# Compute token embeddings
|
538 |
-
with torch.no_grad():
|
539 |
-
model_output = model(**encoded_input)
|
540 |
-
# Perform pooling. In this case, cls pooling.
|
541 |
-
sentence_embeddings = model_output[0][:, 0]
|
542 |
-
# normalize embeddings
|
543 |
-
sentence_embeddings = torch.nn.functional.normalize(sentence_embeddings, p=2, dim=1)
|
544 |
-
print("Sentence embeddings:", sentence_embeddings)
|
545 |
-
```
|
546 |
-
|
547 |
-
### Usage for Reranker
|
548 |
-
|
549 |
-
You can get a relevance score by inputting query and passage to the reranker.
|
550 |
-
The reranker is optimized based cross-entropy loss, so the relevance score is not bounded to a specific range.
|
551 |
-
|
552 |
-
|
553 |
-
#### Using FlagEmbedding
|
554 |
-
```
|
555 |
-
pip install -U FlagEmbedding
|
556 |
-
```
|
557 |
-
|
558 |
-
Get relevance score:
|
559 |
-
```python
|
560 |
-
from FlagEmbedding import FlagReranker
|
561 |
-
reranker = FlagReranker('BAAI/bge-reranker-base', use_fp16=True) #use fp16 can speed up computing
|
562 |
-
|
563 |
-
score = reranker.compute_score(['query', 'passage'])
|
564 |
-
print(score)
|
565 |
-
|
566 |
-
scores = reranker.compute_score([['what is panda?', 'hi'], ['what is panda?', 'The giant panda (Ailuropoda melanoleuca), sometimes called a panda bear or simply panda, is a bear species endemic to China.']])
|
567 |
-
print(scores)
|
568 |
-
```
|
569 |
-
|
570 |
-
|
571 |
-
#### Using Huggingface transformers
|
572 |
-
|
573 |
-
```python
|
574 |
-
import torch
|
575 |
-
from transformers import AutoModelForSequenceClassification, AutoTokenizer, BatchEncoding, PreTrainedTokenizerFast
|
576 |
-
|
577 |
-
tokenizer = AutoTokenizer.from_pretrained('BAAI/bge-reranker-base')
|
578 |
-
model = AutoModelForSequenceClassification.from_pretrained('BAAI/bge-reranker-base')
|
579 |
-
model.eval()
|
580 |
-
|
581 |
-
pairs = [['what is panda?', 'hi'], ['what is panda?', 'The giant panda (Ailuropoda melanoleuca), sometimes called a panda bear or simply panda, is a bear species endemic to China.']]
|
582 |
-
with torch.no_grad():
|
583 |
-
inputs = tokenizer(pairs, padding=True, truncation=True, return_tensors='pt', max_length=512)
|
584 |
-
scores = model(**inputs, return_dict=True).logits.view(-1, ).float()
|
585 |
-
print(scores)
|
586 |
-
```
|
587 |
-
|
588 |
-
## Evaluation
|
589 |
-
|
590 |
-
`baai-general-embedding` models achieve **state-of-the-art performance on both MTEB and C-MTEB leaderboard!**
|
591 |
-
For more details and evaluation tools see our [scripts](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB/README.md).
|
592 |
-
|
593 |
-
- **MTEB**:
|
594 |
-
|
595 |
-
| Model Name | Dimension | Sequence Length | Average (56) | Retrieval (15) |Clustering (11) | Pair Classification (3) | Reranking (4) | STS (10) | Summarization (1) | Classification (12) |
|
596 |
-
|:----:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
597 |
-
| [BAAI/bge-large-en-v1.5](https://huggingface.co/BAAI/bge-large-en-v1.5) | 1024 | 512 | **64.23** | **54.29** | 46.08 | 87.12 | 60.03 | 83.11 | 31.61 | 75.97 |
|
598 |
-
| [BAAI/bge-base-en-v1.5](https://huggingface.co/BAAI/bge-base-en-v1.5) | 768 | 512 | 63.55 | 53.25 | 45.77 | 86.55 | 58.86 | 82.4 | 31.07 | 75.53 |
|
599 |
-
| [BAAI/bge-small-en-v1.5](https://huggingface.co/BAAI/bge-small-en-v1.5) | 384 | 512 | 62.17 |51.68 | 43.82 | 84.92 | 58.36 | 81.59 | 30.12 | 74.14 |
|
600 |
-
| [bge-large-en](https://huggingface.co/BAAI/bge-large-en) | 1024 | 512 | 63.98 | 53.9 | 46.98 | 85.8 | 59.48 | 81.56 | 32.06 | 76.21 |
|
601 |
-
| [bge-base-en](https://huggingface.co/BAAI/bge-base-en) | 768 | 512 | 63.36 | 53.0 | 46.32 | 85.86 | 58.7 | 81.84 | 29.27 | 75.27 |
|
602 |
-
| [gte-large](https://huggingface.co/thenlper/gte-large) | 1024 | 512 | 63.13 | 52.22 | 46.84 | 85.00 | 59.13 | 83.35 | 31.66 | 73.33 |
|
603 |
-
| [gte-base](https://huggingface.co/thenlper/gte-base) | 768 | 512 | 62.39 | 51.14 | 46.2 | 84.57 | 58.61 | 82.3 | 31.17 | 73.01 |
|
604 |
-
| [e5-large-v2](https://huggingface.co/intfloat/e5-large-v2) | 1024| 512 | 62.25 | 50.56 | 44.49 | 86.03 | 56.61 | 82.05 | 30.19 | 75.24 |
|
605 |
-
| [bge-small-en](https://huggingface.co/BAAI/bge-small-en) | 384 | 512 | 62.11 | 51.82 | 44.31 | 83.78 | 57.97 | 80.72 | 30.53 | 74.37 |
|
606 |
-
| [instructor-xl](https://huggingface.co/hkunlp/instructor-xl) | 768 | 512 | 61.79 | 49.26 | 44.74 | 86.62 | 57.29 | 83.06 | 32.32 | 61.79 |
|
607 |
-
| [e5-base-v2](https://huggingface.co/intfloat/e5-base-v2) | 768 | 512 | 61.5 | 50.29 | 43.80 | 85.73 | 55.91 | 81.05 | 30.28 | 73.84 |
|
608 |
-
| [gte-small](https://huggingface.co/thenlper/gte-small) | 384 | 512 | 61.36 | 49.46 | 44.89 | 83.54 | 57.7 | 82.07 | 30.42 | 72.31 |
|
609 |
-
| [text-embedding-ada-002](https://platform.openai.com/docs/guides/embeddings) | 1536 | 8192 | 60.99 | 49.25 | 45.9 | 84.89 | 56.32 | 80.97 | 30.8 | 70.93 |
|
610 |
-
| [e5-small-v2](https://huggingface.co/intfloat/e5-base-v2) | 384 | 512 | 59.93 | 49.04 | 39.92 | 84.67 | 54.32 | 80.39 | 31.16 | 72.94 |
|
611 |
-
| [sentence-t5-xxl](https://huggingface.co/sentence-transformers/sentence-t5-xxl) | 768 | 512 | 59.51 | 42.24 | 43.72 | 85.06 | 56.42 | 82.63 | 30.08 | 73.42 |
|
612 |
-
| [all-mpnet-base-v2](https://huggingface.co/sentence-transformers/all-mpnet-base-v2) | 768 | 514 | 57.78 | 43.81 | 43.69 | 83.04 | 59.36 | 80.28 | 27.49 | 65.07 |
|
613 |
-
| [sgpt-bloom-7b1-msmarco](https://huggingface.co/bigscience/sgpt-bloom-7b1-msmarco) | 4096 | 2048 | 57.59 | 48.22 | 38.93 | 81.9 | 55.65 | 77.74 | 33.6 | 66.19 |
|
614 |
-
|
615 |
-
|
616 |
-
|
617 |
-
- **C-MTEB**:
|
618 |
-
We create the benchmark C-MTEB for Chinese text embedding which consists of 31 datasets from 6 tasks.
|
619 |
-
Please refer to [C_MTEB](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB/README.md) for a detailed introduction.
|
620 |
-
|
621 |
-
| Model | Embedding dimension | Avg | Retrieval | STS | PairClassification | Classification | Reranking | Clustering |
|
622 |
-
|:-------------------------------|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|
|
623 |
-
| [**BAAI/bge-large-zh-v1.5**](https://huggingface.co/BAAI/bge-large-zh-v1.5) | 1024 | **64.53** | 70.46 | 56.25 | 81.6 | 69.13 | 65.84 | 48.99 |
|
624 |
-
| [BAAI/bge-base-zh-v1.5](https://huggingface.co/BAAI/bge-base-zh-v1.5) | 768 | 63.13 | 69.49 | 53.72 | 79.75 | 68.07 | 65.39 | 47.53 |
|
625 |
-
| [BAAI/bge-small-zh-v1.5](https://huggingface.co/BAAI/bge-small-zh-v1.5) | 512 | 57.82 | 61.77 | 49.11 | 70.41 | 63.96 | 60.92 | 44.18 |
|
626 |
-
| [BAAI/bge-large-zh](https://huggingface.co/BAAI/bge-large-zh) | 1024 | 64.20 | 71.53 | 54.98 | 78.94 | 68.32 | 65.11 | 48.39 |
|
627 |
-
| [bge-large-zh-noinstruct](https://huggingface.co/BAAI/bge-large-zh-noinstruct) | 1024 | 63.53 | 70.55 | 53 | 76.77 | 68.58 | 64.91 | 50.01 |
|
628 |
-
| [BAAI/bge-base-zh](https://huggingface.co/BAAI/bge-base-zh) | 768 | 62.96 | 69.53 | 54.12 | 77.5 | 67.07 | 64.91 | 47.63 |
|
629 |
-
| [multilingual-e5-large](https://huggingface.co/intfloat/multilingual-e5-large) | 1024 | 58.79 | 63.66 | 48.44 | 69.89 | 67.34 | 56.00 | 48.23 |
|
630 |
-
| [BAAI/bge-small-zh](https://huggingface.co/BAAI/bge-small-zh) | 512 | 58.27 | 63.07 | 49.45 | 70.35 | 63.64 | 61.48 | 45.09 |
|
631 |
-
| [m3e-base](https://huggingface.co/moka-ai/m3e-base) | 768 | 57.10 | 56.91 | 50.47 | 63.99 | 67.52 | 59.34 | 47.68 |
|
632 |
-
| [m3e-large](https://huggingface.co/moka-ai/m3e-large) | 1024 | 57.05 | 54.75 | 50.42 | 64.3 | 68.2 | 59.66 | 48.88 |
|
633 |
-
| [multilingual-e5-base](https://huggingface.co/intfloat/multilingual-e5-base) | 768 | 55.48 | 61.63 | 46.49 | 67.07 | 65.35 | 54.35 | 40.68 |
|
634 |
-
| [multilingual-e5-small](https://huggingface.co/intfloat/multilingual-e5-small) | 384 | 55.38 | 59.95 | 45.27 | 66.45 | 65.85 | 53.86 | 45.26 |
|
635 |
-
| [text-embedding-ada-002(OpenAI)](https://platform.openai.com/docs/guides/embeddings/what-are-embeddings) | 1536 | 53.02 | 52.0 | 43.35 | 69.56 | 64.31 | 54.28 | 45.68 |
|
636 |
-
| [luotuo](https://huggingface.co/silk-road/luotuo-bert-medium) | 1024 | 49.37 | 44.4 | 42.78 | 66.62 | 61 | 49.25 | 44.39 |
|
637 |
-
| [text2vec-base](https://huggingface.co/shibing624/text2vec-base-chinese) | 768 | 47.63 | 38.79 | 43.41 | 67.41 | 62.19 | 49.45 | 37.66 |
|
638 |
-
| [text2vec-large](https://huggingface.co/GanymedeNil/text2vec-large-chinese) | 1024 | 47.36 | 41.94 | 44.97 | 70.86 | 60.66 | 49.16 | 30.02 |
|
639 |
-
|
640 |
-
|
641 |
-
- **Reranking**:
|
642 |
-
See [C_MTEB](https://github.com/FlagOpen/FlagEmbedding/blob/master/C_MTEB/) for evaluation script.
|
643 |
-
|
644 |
-
| Model | T2Reranking | T2RerankingZh2En\* | T2RerankingEn2Zh\* | MmarcoReranking | CMedQAv1 | CMedQAv2 | Avg |
|
645 |
-
|:-------------------------------|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|:--------:|
|
646 |
-
| text2vec-base-multilingual | 64.66 | 62.94 | 62.51 | 14.37 | 48.46 | 48.6 | 50.26 |
|
647 |
-
| multilingual-e5-small | 65.62 | 60.94 | 56.41 | 29.91 | 67.26 | 66.54 | 57.78 |
|
648 |
-
| multilingual-e5-large | 64.55 | 61.61 | 54.28 | 28.6 | 67.42 | 67.92 | 57.4 |
|
649 |
-
| multilingual-e5-base | 64.21 | 62.13 | 54.68 | 29.5 | 66.23 | 66.98 | 57.29 |
|
650 |
-
| m3e-base | 66.03 | 62.74 | 56.07 | 17.51 | 77.05 | 76.76 | 59.36 |
|
651 |
-
| m3e-large | 66.13 | 62.72 | 56.1 | 16.46 | 77.76 | 78.27 | 59.57 |
|
652 |
-
| bge-base-zh-v1.5 | 66.49 | 63.25 | 57.02 | 29.74 | 80.47 | 84.88 | 63.64 |
|
653 |
-
| bge-large-zh-v1.5 | 65.74 | 63.39 | 57.03 | 28.74 | 83.45 | 85.44 | 63.97 |
|
654 |
-
| [BAAI/bge-reranker-base](https://huggingface.co/BAAI/bge-reranker-base) | 67.28 | 63.95 | 60.45 | 35.46 | 81.26 | 84.1 | 65.42 |
|
655 |
-
| [BAAI/bge-reranker-large](https://huggingface.co/BAAI/bge-reranker-large) | 67.6 | 64.03 | 61.44 | 37.16 | 82.15 | 84.18 | 66.09 |
|
656 |
-
|
657 |
-
\* : T2RerankingZh2En and T2RerankingEn2Zh are cross-language retrieval task
|
658 |
-
|
659 |
-
## Train
|
660 |
-
|
661 |
-
### BAAI Embedding
|
662 |
-
|
663 |
-
We pre-train the models using retromae and train them on large-scale pairs data using contrastive learning.
|
664 |
-
**You can fine-tune the embedding model on your data following our [examples](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/finetune).**
|
665 |
-
We also provide a [pre-train example](https://github.com/FlagOpen/FlagEmbedding/tree/master/examples/pretrain).
|
666 |
-
Note that the goal of pre-training is to reconstruct the text, and the pre-trained model cannot be used for similarity calculation directly, it needs to be fine-tuned.
|
667 |
-
More training details for bge see [baai_general_embedding](https://github.com/FlagOpen/FlagEmbedding/blob/master/FlagEmbedding/baai_general_embedding/README.md).
|
668 |
-
|
669 |
-
|
670 |
-
|
671 |
-
### BGE Reranker
|
672 |
-
|
673 |
-
Cross-encoder will perform full-attention over the input pair,
|
674 |
-
which is more accurate than embedding model (i.e., bi-encoder) but more time-consuming than embedding model.
|
675 |
-
Therefore, it can be used to re-rank the top-k documents returned by embedding model.
|
676 |
-
We train the cross-encoder on a multilingual pair data,
|
677 |
-
The data format is the same as embedding model, so you can fine-tune it easily following our example.
|
678 |
-
More details pelease refer to [./FlagEmbedding/reranker/README.md](./FlagEmbedding/reranker/README.md)
|
679 |
-
|
680 |
-
|
681 |
-
## Contact
|
682 |
-
If you have any question or suggestion related to this project, feel free to open an issue or pull request.
|
683 |
-
You also can email Shitao Xiao([email protected]) and Zheng Liu([email protected]).
|
684 |
-
|
685 |
-
|
686 |
-
## License
|
687 |
-
FlagEmbedding is licensed under the [MIT License](https://github.com/FlagOpen/FlagEmbedding/blob/master/LICENSE). The released models can be used for commercial purposes free of charge.
|
688 |
-
|
689 |
-
|
690 |
-
|
691 |
-
|
692 |
-
|
693 |
-
**Recommend switching to newest bge-large-zh-v1.5, which has more reasonable similarity distribution and same method of usage.**
|
694 |
|
695 |
<h1 align="center">FlagEmbedding</h1>
|
696 |
|
|
|
1 |
+
---
|
2 |
+
license: mit
|
3 |
+
language:
|
4 |
+
- zh
|
5 |
+
pipeline_tag: sentence-similarity
|
6 |
+
---
|
7 |
|
8 |
|
9 |
+
**Recommend switching to newest [BAAI/bge-large-zh-v1.5](https://huggingface.co/BAAI/bge-large-zh-v1.5), which has more reasonable similarity distribution and same method of usage.**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10 |
|
11 |
<h1 align="center">FlagEmbedding</h1>
|
12 |
|