Token Classification
GLiNER
PyTorch
English
Mbiot commited on
Commit
cd64e63
·
verified ·
1 Parent(s): 0c15a77

Upload folder using huggingface_hub

Browse files
.gitattributes CHANGED
@@ -1,35 +1,40 @@
1
- *.7z filter=lfs diff=lfs merge=lfs -text
2
- *.arrow filter=lfs diff=lfs merge=lfs -text
3
- *.bin filter=lfs diff=lfs merge=lfs -text
4
- *.bz2 filter=lfs diff=lfs merge=lfs -text
5
- *.ckpt filter=lfs diff=lfs merge=lfs -text
6
- *.ftz filter=lfs diff=lfs merge=lfs -text
7
- *.gz filter=lfs diff=lfs merge=lfs -text
8
- *.h5 filter=lfs diff=lfs merge=lfs -text
9
- *.joblib filter=lfs diff=lfs merge=lfs -text
10
- *.lfs.* filter=lfs diff=lfs merge=lfs -text
11
- *.mlmodel filter=lfs diff=lfs merge=lfs -text
12
- *.model filter=lfs diff=lfs merge=lfs -text
13
- *.msgpack filter=lfs diff=lfs merge=lfs -text
14
- *.npy filter=lfs diff=lfs merge=lfs -text
15
- *.npz filter=lfs diff=lfs merge=lfs -text
16
- *.onnx filter=lfs diff=lfs merge=lfs -text
17
- *.ot filter=lfs diff=lfs merge=lfs -text
18
- *.parquet filter=lfs diff=lfs merge=lfs -text
19
- *.pb filter=lfs diff=lfs merge=lfs -text
20
- *.pickle filter=lfs diff=lfs merge=lfs -text
21
- *.pkl filter=lfs diff=lfs merge=lfs -text
22
- *.pt filter=lfs diff=lfs merge=lfs -text
23
- *.pth filter=lfs diff=lfs merge=lfs -text
24
- *.rar filter=lfs diff=lfs merge=lfs -text
25
- *.safetensors filter=lfs diff=lfs merge=lfs -text
26
- saved_model/**/* filter=lfs diff=lfs merge=lfs -text
27
- *.tar.* filter=lfs diff=lfs merge=lfs -text
28
- *.tar filter=lfs diff=lfs merge=lfs -text
29
- *.tflite filter=lfs diff=lfs merge=lfs -text
30
- *.tgz filter=lfs diff=lfs merge=lfs -text
31
- *.wasm filter=lfs diff=lfs merge=lfs -text
32
- *.xz filter=lfs diff=lfs merge=lfs -text
33
- *.zip filter=lfs diff=lfs merge=lfs -text
34
- *.zst filter=lfs diff=lfs merge=lfs -text
35
- *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
1
+ *.7z filter=lfs diff=lfs merge=lfs -text
2
+ *.arrow filter=lfs diff=lfs merge=lfs -text
3
+ *.bin filter=lfs diff=lfs merge=lfs -text
4
+ *.bz2 filter=lfs diff=lfs merge=lfs -text
5
+ *.ckpt filter=lfs diff=lfs merge=lfs -text
6
+ *.ftz filter=lfs diff=lfs merge=lfs -text
7
+ *.gz filter=lfs diff=lfs merge=lfs -text
8
+ *.h5 filter=lfs diff=lfs merge=lfs -text
9
+ *.joblib filter=lfs diff=lfs merge=lfs -text
10
+ *.lfs.* filter=lfs diff=lfs merge=lfs -text
11
+ *.mlmodel filter=lfs diff=lfs merge=lfs -text
12
+ *.model filter=lfs diff=lfs merge=lfs -text
13
+ *.msgpack filter=lfs diff=lfs merge=lfs -text
14
+ *.npy filter=lfs diff=lfs merge=lfs -text
15
+ *.npz filter=lfs diff=lfs merge=lfs -text
16
+ *.onnx filter=lfs diff=lfs merge=lfs -text
17
+ *.ot filter=lfs diff=lfs merge=lfs -text
18
+ *.parquet filter=lfs diff=lfs merge=lfs -text
19
+ *.pb filter=lfs diff=lfs merge=lfs -text
20
+ *.pickle filter=lfs diff=lfs merge=lfs -text
21
+ *.pkl filter=lfs diff=lfs merge=lfs -text
22
+ *.pt filter=lfs diff=lfs merge=lfs -text
23
+ *.pth filter=lfs diff=lfs merge=lfs -text
24
+ *.rar filter=lfs diff=lfs merge=lfs -text
25
+ *.safetensors filter=lfs diff=lfs merge=lfs -text
26
+ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
27
+ *.tar.* filter=lfs diff=lfs merge=lfs -text
28
+ *.tar filter=lfs diff=lfs merge=lfs -text
29
+ *.tflite filter=lfs diff=lfs merge=lfs -text
30
+ *.tgz filter=lfs diff=lfs merge=lfs -text
31
+ *.wasm filter=lfs diff=lfs merge=lfs -text
32
+ *.xz filter=lfs diff=lfs merge=lfs -text
33
+ *.zip filter=lfs diff=lfs merge=lfs -text
34
+ *.zst filter=lfs diff=lfs merge=lfs -text
35
+ *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ pytorch_model.bin filter=lfs diff=lfs merge=lfs -text
37
+ assets/countries_distribution.png filter=lfs diff=lfs merge=lfs -text
38
+ assets/entity-types_limited.png filter=lfs diff=lfs merge=lfs -text
39
+ assets/topics_fig_connected.png filter=lfs diff=lfs merge=lfs -text
40
+ assets/zero-shot_18_table.png filter=lfs diff=lfs merge=lfs -text
README.md ADDED
@@ -0,0 +1,156 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ datasets:
4
+ - EmergentMethods/AskNews-NER-v0
5
+ tags:
6
+ - gliner
7
+ language:
8
+ - en
9
+ pipeline_tag: token-classification
10
+ ---
11
+ # Model Card for gliner_large_news-v2.1
12
+
13
+ This model is a fine-tune of [GLiNER](https://huggingface.co/urchade/gliner_large-v2.1) aimed at improving accuracy across a broad range of topics, especially with respect to long-context news entity extraction. As shown in the table below, these fine-tunes improved upon the base GLiNER model zero-shot accuracy by up to 7.5% across 18 benchmark datasets.
14
+
15
+ ![results table](assets/zero-shot_18_table.png)
16
+
17
+ The underlying dataset, [AskNews-NER-v0](https://huggingface.co/datasets/EmergentMethods/AskNews-NER-v0) was engineered with the objective of diversifying global perspectives by enforcing country/language/topic/temporal diversity. All data used to fine-tune this model was synthetically generated. WizardLM 13B v1.2 was used for translation/summarization of open-web news articles, while Llama3 70b instruct was used for entity extraction. Both the diversification and fine-tuning methods are presented in a our paper on [ArXiv](https://arxiv.org/abs/2406.10258).
18
+
19
+ # Usage
20
+
21
+ ```python
22
+ from gliner import GLiNER
23
+
24
+ model = GLiNER.from_pretrained("EmergentMethods/gliner_large_news-v2.1")
25
+
26
+ text = """
27
+ The Chihuahua State Public Security Secretariat (SSPE) arrested 35-year-old Salomón C. T. in Ciudad Juárez, found in possession of a stolen vehicle, a white GMC Yukon, which was reported stolen in the city's streets. The arrest was made by intelligence and police analysis personnel during an investigation in the border city. The arrest is related to a previous detention on February 6, which involved armed men in a private vehicle. The detainee and the vehicle were turned over to the Chihuahua State Attorney General's Office for further investigation into the case.
28
+ """
29
+
30
+ labels = ["person", "location", "date", "event", "facility", "vehicle", "number", "organization"]
31
+
32
+ entities = model.predict_entities(text, labels)
33
+
34
+ for entity in entities:
35
+ print(entity["text"], "=>", entity["label"])
36
+ ```
37
+
38
+ Output:
39
+
40
+ ```
41
+ Chihuahua State Public Security Secretariat => organization
42
+ SSPE => organization
43
+ 35-year-old => number
44
+ Salomón C. T. => person
45
+ Ciudad Juárez => location
46
+ GMC Yukon => vehicle
47
+ February 6 => date
48
+ Chihuahua State Attorney General's Office => organization
49
+ ```
50
+
51
+ ## Model Details
52
+
53
+ ### Model Description
54
+
55
+ <!-- Provide a longer summary of what this model is. -->
56
+
57
+ The synthetic data underlying this news fine-tune was pulled from the [AskNews API](https://docs.asknews.app). We enforced diveristy across country/language/topic/time.
58
+
59
+ Countries:
60
+
61
+ ![country distribution](assets/countries_distribution.png)
62
+
63
+ Entity types:
64
+
65
+ ![entities](assets/entity-types_limited.png)
66
+
67
+ Topics:
68
+
69
+ ![topics](assets/topics_fig_connected.png)
70
+
71
+
72
+ - **Developed by:** [Emergent Methods](https://emergentmethods.ai/)
73
+ - **Funded by:** [Emergent Methods](https://emergentmethods.ai/)
74
+ - **Shared by:** [Emergent Methods](https://emergentmethods.ai/)
75
+ - **Model type:** microsoft/deberta
76
+ - **Language(s) (NLP):** English (en) (English texts and translations from Spanish (es), Portuguese (pt), German (de), Russian (ru), French (fr), Arabic (ar), Italian (it), Ukrainian (uk), Norwegian (no), Swedish (sv), Danish (da)).
77
+ - **License:** Apache 2.0
78
+ - **Finetuned from model:** [GLiNER](https://huggingface.co/urchade/gliner_large-v2.1)
79
+
80
+ ### Model Sources [optional]
81
+
82
+ <!-- Provide the basic links for the model. -->
83
+
84
+ - **Repository:** To be added
85
+ - **Paper:** To be added
86
+ - **Demo:** To be added
87
+
88
+ ## Uses
89
+
90
+ <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
91
+
92
+ ### Direct Use
93
+
94
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
95
+
96
+ As the name suggests, this model is aimed at generalist entity extraction. Although we used news to fine-tune this model, it improved accuracy across 18 benchmark datasets by up to 7.5%. This means that the broad and diversified underlying dataset has helped it to recognize and extract more entity types.
97
+
98
+ This model is shockingly compact, and can be used for high-throughput production usecases. This is another reason we have licensed this as Apache 2.0. Currently, [AskNews](https://asknews.app) is using this fine-tune for entity extraction in their system.
99
+
100
+
101
+ ## Bias, Risks, and Limitations
102
+
103
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
104
+
105
+ Although the goal of the dataset is to reduce bias, and improve diversity, it is still biased to western languages and countries. This limitation originates from the abilities of Llama2 for the translation and summary generations. Further, any bias originating in Llama2 training data will also be present in this dataset, since Llama2 was used to summarize the open-web articles. Further, any biases present in Llama3 will be present in the present dataaset since Llama3 was used to extract entities from the summaries.
106
+
107
+ ![countries distribution](figures/topics_fig_connected.png)
108
+
109
+
110
+ ## How to Get Started with the Model
111
+
112
+ Use the code below to get started with the model.
113
+
114
+
115
+
116
+ ## Training Details
117
+
118
+ <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
119
+
120
+ The training dataset is [AskNews-NER-v0](https://huggingface.co/datasets/EmergentMethods/AskNews-NER-v0).
121
+
122
+ Other training details can be found in the [companion paper](https://linktoarxiv.org).
123
+
124
+
125
+
126
+ ## Environmental Impact
127
+
128
+ <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
129
+
130
+ - **Hardware Type:** 1xA4500
131
+ - **Hours used:** 10
132
+ - **Carbon Emitted:** 0.6 kg (According to [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute))
133
+
134
+
135
+ ## Citation
136
+
137
+ <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
138
+
139
+ **BibTeX:**
140
+
141
+ To be added
142
+
143
+ **APA:**
144
+
145
+ To be added
146
+
147
+ ## Model Authors
148
+
149
+ Elin Törnquist, Emergent Methods elin at emergentmethods.ai
150
+ Robert Caulk, Emergent Methods rob at emergentmethods.ai
151
+
152
+
153
+ ## Model Contact
154
+
155
+ Elin Törnquist, Emergent Methods elin at emergentmethods.ai
156
+ Robert Caulk, Emergent Methods rob at emergentmethods.ai
assets/countries_distribution.png ADDED

Git LFS Details

  • SHA256: df265a6bcee74209fe23a443b80088ddafd8970c212acc785e013af45bbb7be4
  • Pointer size: 131 Bytes
  • Size of remote file: 398 kB
assets/entity-types_limited.png ADDED

Git LFS Details

  • SHA256: ddcc6f30e3367a995f08223a4bcc6b51544b68f99c2da31a2620d579f2518895
  • Pointer size: 131 Bytes
  • Size of remote file: 179 kB
assets/topics_fig_connected.png ADDED

Git LFS Details

  • SHA256: d3aecd2cdb60e2861ed82dfc69a33a2a73128e2d0b9dfe57707c3bcc6cb115dd
  • Pointer size: 131 Bytes
  • Size of remote file: 172 kB
assets/zero-shot_18_table.png ADDED

Git LFS Details

  • SHA256: 38d2b53edc00699666819376c3eec4ea14e64b0a6550a458f9fc2447e8ffe7b4
  • Pointer size: 131 Bytes
  • Size of remote file: 344 kB
gliner_config.json ADDED
@@ -0,0 +1,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "size_sup": -1,
3
+ "max_types": 30,
4
+ "shuffle_types": true,
5
+ "random_drop": true,
6
+ "max_neg_type_ratio": 1,
7
+ "max_len": 296,
8
+ "lr_encoder": "1e-5",
9
+ "lr_others": "5e-5",
10
+ "num_steps": 30000,
11
+ "warmup_ratio": 3000,
12
+ "train_batch_size": 8,
13
+ "eval_every": 5000,
14
+ "max_width": 12,
15
+ "model_name": "microsoft/deberta-v3-large",
16
+ "fine_tune": true,
17
+ "subtoken_pooling": "first",
18
+ "hidden_size": 512,
19
+ "span_mode": "markerV0",
20
+ "dropout": 0.4,
21
+ "name": "correct"
22
+ }
pytorch_model.bin ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:9aa8388917daf4ccbb36c939a551dda099820ef5c34f84c1ad3bf9420f0662db
3
+ size 1782048942