chore: update readme
Browse files
README.md
CHANGED
@@ -21,3 +21,97 @@ license: cc-by-nc-4.0
|
|
21 |
</p>
|
22 |
|
23 |
# jina-reranker-v2-base-multilingual
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21 |
</p>
|
22 |
|
23 |
# jina-reranker-v2-base-multilingual
|
24 |
+
|
25 |
+
|
26 |
+
# Usage
|
27 |
+
|
28 |
+
1. The easiest way to starting using `jina-reranker-v2-base-multilingual` is to use Jina AI's [Reranker API](https://jina.ai/reranker/).
|
29 |
+
|
30 |
+
```bash
|
31 |
+
curl https://api.jina.ai/v1/rerank \
|
32 |
+
-H "Content-Type: application/json" \
|
33 |
+
-H "Authorization: Bearer YOUR_API_KEY" \
|
34 |
+
-d '{
|
35 |
+
"model": "jina-reranker-v2-base-multilingual",
|
36 |
+
"query": "Organic skincare products for sensitive skin",
|
37 |
+
"documents": [
|
38 |
+
"Eco-friendly kitchenware for modern homes",
|
39 |
+
"Biodegradable cleaning supplies for eco-conscious consumers",
|
40 |
+
"Organic cotton baby clothes for sensitive skin",
|
41 |
+
"Natural organic skincare range for sensitive skin",
|
42 |
+
"Tech gadgets for smart homes: 2024 edition",
|
43 |
+
"Sustainable gardening tools and compost solutions",
|
44 |
+
"Sensitive skin-friendly facial cleansers and toners",
|
45 |
+
"Organic food wraps and storage solutions",
|
46 |
+
"All-natural pet food for dogs with allergies",
|
47 |
+
"Yoga mats made from recycled materials"
|
48 |
+
],
|
49 |
+
"top_n": 3
|
50 |
+
}'
|
51 |
+
```
|
52 |
+
|
53 |
+
2. Alternatively, you can use the latest version of the `sentence-transformers>=0.27.0` library. You can install it via pip:
|
54 |
+
|
55 |
+
```bash
|
56 |
+
pip install -U sentence-transformers
|
57 |
+
```
|
58 |
+
|
59 |
+
Then, you can use the following code to interact with the model:
|
60 |
+
|
61 |
+
```python
|
62 |
+
from sentence_transformers import CrossEncoder
|
63 |
+
|
64 |
+
# Load the model, here we use our base sized model
|
65 |
+
model = CrossEncoder("jinaai/jina-reranker-v2-base-multilingual", num_labels=1, trust_remote_code=True)
|
66 |
+
|
67 |
+
|
68 |
+
# Example query and documents
|
69 |
+
query = "Organic skincare products for sensitive skin"
|
70 |
+
documents = [
|
71 |
+
"Eco-friendly kitchenware for modern homes",
|
72 |
+
"Biodegradable cleaning supplies for eco-conscious consumers",
|
73 |
+
"Organic cotton baby clothes for sensitive skin",
|
74 |
+
"Natural organic skincare range for sensitive skin",
|
75 |
+
"Tech gadgets for smart homes: 2024 edition",
|
76 |
+
"Sustainable gardening tools and compost solutions",
|
77 |
+
"Sensitive skin-friendly facial cleansers and toners",
|
78 |
+
"Organic food wraps and storage solutions",
|
79 |
+
"All-natural pet food for dogs with allergies",
|
80 |
+
"Yoga mats made from recycled materials"
|
81 |
+
]
|
82 |
+
|
83 |
+
results = model.rank(query, documents, return_documents=True, top_k=3)
|
84 |
+
```
|
85 |
+
|
86 |
+
3. You can also use the `transformers` library to interact with the model programmatically.
|
87 |
+
|
88 |
+
```python
|
89 |
+
!pip install transformers
|
90 |
+
from transformers import AutoModelForSequenceClassification
|
91 |
+
|
92 |
+
model = AutoModelForSequenceClassification.from_pretrained(
|
93 |
+
'jinaai/jina-reranker-v2-base-multilingual', num_labels=1, trust_remote_code=True
|
94 |
+
)
|
95 |
+
|
96 |
+
# Example query and documents
|
97 |
+
query = "Organic skincare products for sensitive skin"
|
98 |
+
documents = [
|
99 |
+
"Eco-friendly kitchenware for modern homes",
|
100 |
+
"Biodegradable cleaning supplies for eco-conscious consumers",
|
101 |
+
"Organic cotton baby clothes for sensitive skin",
|
102 |
+
"Natural organic skincare range for sensitive skin",
|
103 |
+
"Tech gadgets for smart homes: 2024 edition",
|
104 |
+
"Sustainable gardening tools and compost solutions",
|
105 |
+
"Sensitive skin-friendly facial cleansers and toners",
|
106 |
+
"Organic food wraps and storage solutions",
|
107 |
+
"All-natural pet food for dogs with allergies",
|
108 |
+
"Yoga mats made from recycled materials"
|
109 |
+
]
|
110 |
+
|
111 |
+
# construct sentence pairs
|
112 |
+
sentence_pairs = [[query, doc] for doc in documents]
|
113 |
+
|
114 |
+
scores = model.compute_score(sentence_pairs)
|
115 |
+
```
|
116 |
+
|
117 |
+
That's it! You can now use the `jina-reranker-v2-base-multilingual` model in your projects.
|