File size: 13,742 Bytes
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e4923b6
64664ba
50a0600
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7477f0d
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
afe95e4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
50a0600
afe95e4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
ab145f9
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
ab145f9
64664ba
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
---
license: apache-2.0
language:
- en
metrics:
- f1
- precision
- recall
tags:
- NER
- information extraction
- relation extraction
- summarization
- sentiment extraction
- question-answering
pipeline_tag: token-classification
---
🚀 Meet the first multi-task prompt-tunable GLiNER model 🚀

**GLiNER-Multitask** is a model designed to extract various pieces of information from plain text based on a user-provided custom prompt. This versatile model leverages a bidirectional transformer encoder, similar to BERT, which ensures both high generalization and compute efficiency despite its compact size.

The `gliner-multitask-large` variant achieves state-of-the-art performance on NER zero-shot benchmarks, demonstrating its robustness and flexibility. It excels not only in named entity recognition but also in handling various other information extraction tasks, making it a powerful tool for diverse natural language processing applications.

### Supported tasks:
* **Named Entity Recognition (NER)**: Identifies and categorizes entities such as names, organizations, dates, and other specific items in the text.
* **Relation Extraction**: Detects and classifies relationships between entities within the text.
* **Summarization**: Extract the most important sentences that summarize the input text, capturing the essential information.
* **Sentiment Extraction**: Identify parts of the text that signalize a positive, negative, or neutral sentiment;
* **Key-Phrase Extraction**: Identifies and extracts important phrases and keywords from the text.
* **Question-answering**: Finding an answer in the text given a question;
* **Open Information Extraction**: Extracts pieces of text given an open prompt from a user, for example, product description extraction;


### Installation 	
To use this model, you must install the GLiNER Python library:

```bash
pip install gliner
```

Once you've downloaded the GLiNER library, you can import the GLiNER class. You can then load this model using GLiNER.from_pretrained.

**How to use for NER:**

```python
from gliner import GLiNER

model = GLiNER.from_pretrained("knowledgator/gliner-multitask-large-v0.5)

text = """
Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975 to develop and sell BASIC interpreters for the Altair 8800. During his career at Microsoft, Gates held the positions of chairman, chief executive officer, president and chief software architect, while also being the largest individual shareholder until May 2014.
"""

labels = ["founder", "computer", "software", "position", "date"]

entities = model.predict_entities(text, labels)

for entity in entities:
    print(entity["text"], "=>", entity["label"])
```

**How to use for relation extraction:**

```python
text = """
Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975 to develop and sell BASIC interpreters for the Altair 8800. During his career at Microsoft, Gates held the positions of chairman, chief executive officer, president and chief software architect, while also being the largest individual shareholder until May 2014.
"""

labels = ["Microsoft <> founder", "Microsoft <> inception date", "Bill Gates <> held position"]

entities = model.predict_entities(text, labels)

for entity in entities:
    print(entity["label"], “=>”, entity["text"])
```
### Construct relations extraction pipeline with [utca](https://github.com/Knowledgator/utca)
First of all, we need import neccessary components of the library and initalize predictor - GLiNER model and construct pipeline that combines NER and realtions extraction:
```python
from utca.core import RenameAttribute
from utca.implementation.predictors import (
    GLiNERPredictor,
    GLiNERPredictorConfig
)
from utca.implementation.tasks import (
    GLiNER,
    GLiNERPreprocessor,
    GLiNERRelationExtraction,
    GLiNERRelationExtractionPreprocessor,
)

predictor = GLiNERPredictor( # Predictor manages the model that will be used by tasks
    GLiNERPredictorConfig(
        model_name = "knowledgator/gliner-multitask-large-v0.5", # Model to use
        device = "cuda:0", # Device to use
    )
)

pipe = (
    GLiNER( # GLiNER task produces classified entities that will be at the "output" key.
        predictor=predictor,
        preprocess=GLiNERPreprocessor(threshold=0.7) # Entities threshold
    ) 
    | RenameAttribute("output", "entities") # Rename output entities from GLiNER task to use them as inputs in GLiNERRelationExtraction
    | GLiNERRelationExtraction( # GLiNERRelationExtraction is used for relation extraction.
        predictor=predictor,
        preprocess=(
            GLiNERPreprocessor(threshold=0.5) # Relations threshold
            | GLiNERRelationExtractionPreprocessor()
        )
    )
)
```

To run pipeline we need to specify entity types and relations with their parameters:

```python
r = pipe.run({
    "text": text, # Text to process
    "labels": [ # Labels used by GLiNER for entity extraction
        "scientist",
        "university",
        "city",
        "research",
        "journal",
    ],
    "relations": [{ # Relation parameters
        "relation": "published at", # Relation label. Required parameter.
        "pairs_filter": [("scientist", "journal")], # Optional parameter. It specifies possible members of relations by their entity labels.
        # Here, "scientist" is the entity label of the source, and "journal" is the target's entity label.
        # If provided, only specified pairs will be returned.
    },{
        "relation": "worked at",
        "pairs_filter": [("scientist", "university"), ("scientist", "other")],
        "distance_threshold": 100, # Optional parameter. It specifies the max distance between spans in the text (i.e., the end of the span that is closer to the start of the text and the start of the next one).
    }]
})

print(r["output"])
```

**How to use for open information extraction:**

```python
prompt = """Find all positive aspects about the product:\n"""
text = """
I recently purchased the Sony WH-1000XM4 Wireless Noise-Canceling Headphones from Amazon and I must say, I'm thoroughly impressed. The package arrived in New York within 2 days, thanks to Amazon Prime's expedited shipping.

The headphones themselves are remarkable. The noise-canceling feature works like a charm in the bustling city environment, and the 30-hour battery life means I don't have to charge them every day. Connecting them to my Samsung Galaxy S21 was a breeze, and the sound quality is second to none.

I also appreciated the customer service from Amazon when I had a question about the warranty. They responded within an hour and provided all the information I needed.

However, the headphones did not come with a hard case, which was listed in the product description. I contacted Amazon, and they offered a 10% discount on my next purchase as an apology.

Overall, I'd give these headphones a 4.5/5 rating and highly recommend them to anyone looking for top-notch quality in both product and service.
"""

input_ = prompt+text

labels = ["match"]

matches = model.predict_entities(input_, labels)

for match in matches:
    print(match["text"], "=>", match["score"])
```

**How to use for question-answering:**

```python
question = "Who was the CEO of Microsoft?"
text = """
Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975, to develop and sell BASIC interpreters for the Altair 8800. During his career at Microsoft, Gates held the positions of chairman, chief executive officer, president and chief software architect, while also being the largest individual shareholder until May 2014.
"""

labels = ["answer"]

input_ = question+text
answers = model.predict_entities(input_, labels)

for answer in answers:
    print(answer["text"], "=>", answer["score"])
```

**How to use for summarization:**

With threshold parameters, you can control how much information you want to extract.

```python
prompt = "Summarize the given text, highlighting the most important information:\n"

text = """
Several studies have reported its pharmacological activities, including anti-inflammatory, antimicrobial, and antitumoral effects.
The effect of E-anethole was studied in the osteosarcoma MG-63 cell line, and the antiproliferative activity was evaluated by an MTT assay.
It showed a GI50 value of 60.25 μM with apoptosis induction through the mitochondrial-mediated pathway. Additionally, it induced cell cycle arrest at the G0/G1 phase, up-regulated the expression of p53, caspase-3, and caspase-9, and down-regulated Bcl-xL expression.
Moreover, the antitumoral activity of anethole was assessed against oral tumor Ca9-22 cells, and the cytotoxic effects were evaluated by MTT and LDH assays.
It demonstrated a LD50 value of 8 μM, and cellular proliferation was 42.7% and 5.2% at anethole concentrations of 3 μM and 30 μM, respectively.
It was reported that it could selectively and in a dose-dependent manner decrease cell proliferation and induce apoptosis, as well as induce autophagy, decrease ROS production, and increase glutathione activity. The cytotoxic effect was mediated through NF-kB, MAP kinases, Wnt, caspase-3 and -9, and PARP1 pathways. Additionally, treatment with anethole inhibited cyclin D1 oncogene expression, increased cyclin-dependent kinase inhibitor p21WAF1, up-regulated p53 expression, and inhibited the EMT markers.
"""

labels = ["summary"]

input_ = prompt+text

threshold = 0.5
summaries = model.predict_entities(input_, labels, threshold=treashold)

for summary in summaries:
    print(summary["text"], "=>", summary["score"])
```

### Benchmarks:

Our multitask model demonstrates comparable performance on different zero-shot benchmarks to dedicated models to NER task:

| Model                              | Dataset            | Precision | Recall | F1 Score | F1 Score (Decimal) |
|------------------------------------|--------------------|-----------|--------|----------|--------------------|
| numind/NuNER_Zero-span             | CrossNER_AI        | 63.82%    | 56.82% | 60.12%   | 0.6012             |
|                                    | CrossNER_literature| 73.53%    | 58.06% | 64.89%   | 0.6489             |
|                                    | CrossNER_music     | 72.69%    | 67.40% | 69.95%   | 0.6995             |
|                                    | CrossNER_politics  | 77.28%    | 68.69% | 72.73%   | 0.7273             |
|                                    | CrossNER_science   | 70.08%    | 63.12% | 66.42%   | 0.6642             |
|                                    | mit-movie          | 63.00%    | 48.88% | 55.05%   | 0.5505             |
|                                    | mit-restaurant     | 51.30%    | 34.35% | 41.15%   | 0.4115             |
|                                    | **Average**        |           |        |          | **0.6147**         |
| knowledgator/gliner-multitask-large| CrossNER_AI        | 52.36%    | 50.39% | 51.36%   | 0.5136             |
|                                    | CrossNER_literature| 70.26%    | 61.60% | 65.65%   | 0.6565             |
|                                    | CrossNER_music     | 73.59%    | 70.28% | 71.89%   | 0.7189             |
|                                    | CrossNER_politics  | 79.74%    | 77.76% | 78.74%   | 0.7874             |
|                                    | CrossNER_science   | 69.13%    | 64.25% | 66.60%   | 0.6660             |
|                                    | mit-movie          | 61.67%    | 51.69% | 56.24%   | 0.5624             |
|                                    | mit-restaurant     | 48.95%    | 39.21% | 43.54%   | 0.4354             |
|                                    | **Average**        |           |        |          | **0.6200**         |
| urchade/gliner_large-v2.1          | CrossNER_AI        | 54.98%    | 52.00% | 53.45%   | 0.5345             |
|                                    | CrossNER_literature| 59.33%    | 56.47% | 57.87%   | 0.5787             |
|                                    | CrossNER_music     | 67.39%    | 66.77% | 67.08%   | 0.6708             |
|                                    | CrossNER_politics  | 66.07%    | 63.76% | 64.90%   | 0.6490             |
|                                    | CrossNER_science   | 61.45%    | 62.56% | 62.00%   | 0.6200             |
|                                    | mit-movie          | 55.94%    | 47.36% | 51.29%   | 0.5129             |
|                                    | mit-restaurant     | 52.89%    | 40.63% | 45.96%   | 0.4596             |
|                                    | **Average**        |           |        |          | **0.5751**         |
| EmergentMethods/gliner_large_news-v2.1| CrossNER_AI    | 59.60%    | 54.55% | 56.96%   | 0.5696             |
|                                    | CrossNER_literature| 65.41%    | 56.16% | 60.44%   | 0.6044             |
|                                    | CrossNER_music     | 67.47%    | 63.08% | 65.20%   | 0.6520             |
|                                    | CrossNER_politics  | 66.05%    | 60.07% | 62.92%   | 0.6292             |
|                                    | CrossNER_science   | 68.44%    | 63.57% | 65.92%   | 0.6592             |
|                                    | mit-movie          | 65.85%    | 49.59% | 56.57%   | 0.5657             |
|                                    | mit-restaurant     | 51.54%    | 35.11% | 41.77%   | 0.4177             |
|                                    | **Average**        |           |        |          | **0.5854**         |


### Join Our Discord

Connect with our community on Discord for news, support, and discussion about our models. Join [Discord](https://discord.gg/dkyeAgs9DG).