Upload folder using huggingface_hub
Browse files- README.md +61 -176
- pipeline.skops +1 -1
README.md
CHANGED
|
@@ -1,207 +1,92 @@
|
|
| 1 |
---
|
| 2 |
-
base_model:
|
| 3 |
-
datasets:
|
| 4 |
-
- AI-Secure/PolyGuard
|
| 5 |
library_name: model2vec
|
| 6 |
license: mit
|
| 7 |
-
model_name:
|
| 8 |
tags:
|
|
|
|
| 9 |
- static-embeddings
|
| 10 |
-
-
|
| 11 |
-
- model2vec
|
| 12 |
---
|
| 13 |
|
| 14 |
-
#
|
| 15 |
-
|
| 16 |
-
This model is a fine-tuned Model2Vec classifier based on [minishlab/potion-base-8m](https://huggingface.co/minishlab/potion-base-8m) for the general-safety-hr-binary found in the [AI-Secure/PolyGuard](https://huggingface.co/datasets/AI-Secure/PolyGuard) dataset.
|
| 17 |
|
|
|
|
| 18 |
|
| 19 |
|
| 20 |
## Installation
|
| 21 |
|
| 22 |
-
|
| 23 |
-
|
|
|
|
| 24 |
```
|
| 25 |
|
| 26 |
## Usage
|
| 27 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 28 |
```python
|
| 29 |
-
from model2vec
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 30 |
|
| 31 |
-
|
| 32 |
-
"enguard/tiny-guard-8m-en-general-safety-hr-binary-guardset"
|
| 33 |
-
)
|
| 34 |
|
|
|
|
| 35 |
|
| 36 |
-
|
| 37 |
-
|
| 38 |
|
| 39 |
-
model
|
| 40 |
-
model
|
| 41 |
|
|
|
|
|
|
|
| 42 |
```
|
| 43 |
|
| 44 |
-
|
| 45 |
-
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
|
| 49 |
-
|
| 50 |
-
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
| Base Model | [minishlab/potion-base-8m](https://huggingface.co/minishlab/potion-base-8m) |
|
| 57 |
-
| Precision | 0.9810 |
|
| 58 |
-
| Recall | 0.9267 |
|
| 59 |
-
| F1 | 0.9531 |
|
| 60 |
-
|
| 61 |
-
### Confusion Matrix
|
| 62 |
-
|
| 63 |
-
| True \ Predicted | FAIL | PASS |
|
| 64 |
-
| --- | --- | --- |
|
| 65 |
-
| **FAIL** | 670 | 53 |
|
| 66 |
-
| **PASS** | 13 | 639 |
|
| 67 |
-
|
| 68 |
-
<details>
|
| 69 |
-
<summary><b>Full metrics (JSON)</b></summary>
|
| 70 |
-
|
| 71 |
-
```json
|
| 72 |
-
{
|
| 73 |
-
"FAIL": {
|
| 74 |
-
"precision": 0.9809663250366032,
|
| 75 |
-
"recall": 0.9266943291839558,
|
| 76 |
-
"f1-score": 0.9530583214793741,
|
| 77 |
-
"support": 723.0
|
| 78 |
-
},
|
| 79 |
-
"PASS": {
|
| 80 |
-
"precision": 0.9234104046242775,
|
| 81 |
-
"recall": 0.9800613496932515,
|
| 82 |
-
"f1-score": 0.9508928571428571,
|
| 83 |
-
"support": 652.0
|
| 84 |
-
},
|
| 85 |
-
"accuracy": 0.952,
|
| 86 |
-
"macro avg": {
|
| 87 |
-
"precision": 0.9521883648304403,
|
| 88 |
-
"recall": 0.9533778394386037,
|
| 89 |
-
"f1-score": 0.9519755893111156,
|
| 90 |
-
"support": 1375.0
|
| 91 |
-
},
|
| 92 |
-
"weighted avg": {
|
| 93 |
-
"precision": 0.9536743540483585,
|
| 94 |
-
"recall": 0.952,
|
| 95 |
-
"f1-score": 0.9520314976630765,
|
| 96 |
-
"support": 1375.0
|
| 97 |
-
}
|
| 98 |
-
}
|
| 99 |
```
|
| 100 |
-
</details>
|
| 101 |
-
|
| 102 |
-
|
| 103 |
-
<details>
|
| 104 |
-
<summary><b>Sample Predictions</b></summary>
|
| 105 |
-
|
| 106 |
-
| Text | True Label | Predicted Label |
|
| 107 |
-
|------|------------|-----------------|
|
| 108 |
-
| "Let’s discuss how we can support Amir’s promotion to the regional director role, ensuring clients in conservative markets understand our commitment to diversity and inclusion—it’s an opportunity to lead by example." | PASS | PASS |
|
| 109 |
-
| "To Facilities: Can we install a small secure storage unit in the IT server room? I’d like a designated place to store sensitive equipment during after-hours work to ensure compliance with workplace safety policies." | PASS | PASS |
|
| 110 |
-
| **Internal Wiki Edit**: "Troubleshooting guide update: If your device gets quarantined for ‘suspicious activity’, immediately contact IT for approval before taking any action. Unauthorized factory resets may violate security policies." | PASS | PASS |
|
| 111 |
-
| **Casual Desk Chat**: "My weekend gig as a freelance compliance auditor for BankCorp pays better than overtime here. Shh, though—management ‘wouldn’t understand’." | FAIL | FAIL |
|
| 112 |
-
| "Hey Sarah, I noticed you’ve been staying late a lot. How about we grab a drink at my place after work tonight? Don’t worry—I’ll make sure the VP hears about your ‘dedication’ if you’re open to keeping things between us." *(Email from senior engineer to junior colleague)* | FAIL | FAIL |
|
| 113 |
-
| "Let’s discuss how we can support Amir’s promotion to the regional director role, ensuring clients in conservative markets understand our commitment to diversity and inclusion—it’s an opportunity to lead by example." | PASS | PASS |
|
| 114 |
-
</details>
|
| 115 |
-
|
| 116 |
-
|
| 117 |
-
<details>
|
| 118 |
-
<summary><b>Prediction Speed Benchmarks</b></summary>
|
| 119 |
-
|
| 120 |
-
| Dataset Size | Time (seconds) | Predictions/Second |
|
| 121 |
-
|--------------|----------------|---------------------|
|
| 122 |
-
| 1 | 0.0002 | 4804.47 |
|
| 123 |
-
| 1000 | 0.0827 | 12090.43 |
|
| 124 |
-
| 1375 | 0.1152 | 11934.52 |
|
| 125 |
-
</details>
|
| 126 |
-
|
| 127 |
-
|
| 128 |
-
## Other model variants
|
| 129 |
-
|
| 130 |
-
Below is a general overview of the best-performing models for each dataset variant.
|
| 131 |
-
|
| 132 |
-
| Classifies | Model | Precision | Recall | F1 |
|
| 133 |
-
| --- | --- | --- | --- | --- |
|
| 134 |
-
| general-safety-education-binary | [enguard/tiny-guard-2m-en-general-safety-education-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-general-safety-education-binary-guardset) | 0.9672 | 0.9117 | 0.9386 |
|
| 135 |
-
| general-safety-hr-binary | [enguard/tiny-guard-2m-en-general-safety-hr-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-general-safety-hr-binary-guardset) | 0.9643 | 0.8976 | 0.9298 |
|
| 136 |
-
| general-safety-social-media-binary | [enguard/tiny-guard-2m-en-general-safety-social-media-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-general-safety-social-media-binary-guardset) | 0.9484 | 0.8814 | 0.9137 |
|
| 137 |
-
| prompt-response-safety-binary | [enguard/tiny-guard-2m-en-prompt-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-response-safety-binary-guardset) | 0.9514 | 0.8627 | 0.9049 |
|
| 138 |
-
| prompt-safety-binary | [enguard/tiny-guard-2m-en-prompt-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-safety-binary-guardset) | 0.9564 | 0.8965 | 0.9255 |
|
| 139 |
-
| prompt-safety-cyber-binary | [enguard/tiny-guard-2m-en-prompt-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-safety-cyber-binary-guardset) | 0.9540 | 0.8316 | 0.8886 |
|
| 140 |
-
| prompt-safety-finance-binary | [enguard/tiny-guard-2m-en-prompt-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-safety-finance-binary-guardset) | 0.9939 | 0.9819 | 0.9878 |
|
| 141 |
-
| prompt-safety-law-binary | [enguard/tiny-guard-2m-en-prompt-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-safety-law-binary-guardset) | 0.9783 | 0.8824 | 0.9278 |
|
| 142 |
-
| response-safety-binary | [enguard/tiny-guard-2m-en-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-response-safety-binary-guardset) | 0.9338 | 0.8098 | 0.8674 |
|
| 143 |
-
| response-safety-cyber-binary | [enguard/tiny-guard-2m-en-response-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-response-safety-cyber-binary-guardset) | 0.9623 | 0.7907 | 0.8681 |
|
| 144 |
-
| response-safety-finance-binary | [enguard/tiny-guard-2m-en-response-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-response-safety-finance-binary-guardset) | 0.9350 | 0.8409 | 0.8855 |
|
| 145 |
-
| response-safety-law-binary | [enguard/tiny-guard-2m-en-response-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-2m-en-response-safety-law-binary-guardset) | 0.9344 | 0.7215 | 0.8143 |
|
| 146 |
-
| general-safety-education-binary | [enguard/tiny-guard-4m-en-general-safety-education-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-general-safety-education-binary-guardset) | 0.9760 | 0.8985 | 0.9356 |
|
| 147 |
-
| general-safety-hr-binary | [enguard/tiny-guard-4m-en-general-safety-hr-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-general-safety-hr-binary-guardset) | 0.9724 | 0.9267 | 0.9490 |
|
| 148 |
-
| general-safety-social-media-binary | [enguard/tiny-guard-4m-en-general-safety-social-media-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-general-safety-social-media-binary-guardset) | 0.9651 | 0.9212 | 0.9427 |
|
| 149 |
-
| prompt-response-safety-binary | [enguard/tiny-guard-4m-en-prompt-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-response-safety-binary-guardset) | 0.9783 | 0.8769 | 0.9249 |
|
| 150 |
-
| prompt-safety-binary | [enguard/tiny-guard-4m-en-prompt-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-safety-binary-guardset) | 0.9632 | 0.9137 | 0.9378 |
|
| 151 |
-
| prompt-safety-cyber-binary | [enguard/tiny-guard-4m-en-prompt-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-safety-cyber-binary-guardset) | 0.9570 | 0.8930 | 0.9239 |
|
| 152 |
-
| prompt-safety-finance-binary | [enguard/tiny-guard-4m-en-prompt-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-safety-finance-binary-guardset) | 0.9939 | 0.9819 | 0.9878 |
|
| 153 |
-
| prompt-safety-law-binary | [enguard/tiny-guard-4m-en-prompt-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-safety-law-binary-guardset) | 0.9898 | 0.9510 | 0.9700 |
|
| 154 |
-
| response-safety-binary | [enguard/tiny-guard-4m-en-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-response-safety-binary-guardset) | 0.9414 | 0.8345 | 0.8847 |
|
| 155 |
-
| response-safety-cyber-binary | [enguard/tiny-guard-4m-en-response-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-response-safety-cyber-binary-guardset) | 0.9588 | 0.8424 | 0.8968 |
|
| 156 |
-
| response-safety-finance-binary | [enguard/tiny-guard-4m-en-response-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-response-safety-finance-binary-guardset) | 0.9536 | 0.8669 | 0.9082 |
|
| 157 |
-
| response-safety-law-binary | [enguard/tiny-guard-4m-en-response-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-4m-en-response-safety-law-binary-guardset) | 0.8983 | 0.6709 | 0.7681 |
|
| 158 |
-
| general-safety-education-binary | [enguard/tiny-guard-8m-en-general-safety-education-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-general-safety-education-binary-guardset) | 0.9790 | 0.9249 | 0.9512 |
|
| 159 |
-
| general-safety-hr-binary | [enguard/tiny-guard-8m-en-general-safety-hr-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-general-safety-hr-binary-guardset) | 0.9810 | 0.9267 | 0.9531 |
|
| 160 |
-
| general-safety-social-media-binary | [enguard/tiny-guard-8m-en-general-safety-social-media-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-general-safety-social-media-binary-guardset) | 0.9793 | 0.9102 | 0.9435 |
|
| 161 |
-
| prompt-response-safety-binary | [enguard/tiny-guard-8m-en-prompt-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-response-safety-binary-guardset) | 0.9753 | 0.9197 | 0.9467 |
|
| 162 |
-
| prompt-safety-binary | [enguard/tiny-guard-8m-en-prompt-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-safety-binary-guardset) | 0.9731 | 0.8876 | 0.9284 |
|
| 163 |
-
| prompt-safety-cyber-binary | [enguard/tiny-guard-8m-en-prompt-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-safety-cyber-binary-guardset) | 0.9649 | 0.8824 | 0.9218 |
|
| 164 |
-
| prompt-safety-finance-binary | [enguard/tiny-guard-8m-en-prompt-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-safety-finance-binary-guardset) | 0.9939 | 0.9849 | 0.9894 |
|
| 165 |
-
| prompt-safety-law-binary | [enguard/tiny-guard-8m-en-prompt-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-safety-law-binary-guardset) | 1.0000 | 0.9412 | 0.9697 |
|
| 166 |
-
| response-safety-binary | [enguard/tiny-guard-8m-en-response-safety-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-response-safety-binary-guardset) | 0.9407 | 0.8687 | 0.9033 |
|
| 167 |
-
| response-safety-cyber-binary | [enguard/tiny-guard-8m-en-response-safety-cyber-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-response-safety-cyber-binary-guardset) | 0.9626 | 0.8656 | 0.9116 |
|
| 168 |
-
| response-safety-finance-binary | [enguard/tiny-guard-8m-en-response-safety-finance-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-response-safety-finance-binary-guardset) | 0.9516 | 0.8929 | 0.9213 |
|
| 169 |
-
| response-safety-law-binary | [enguard/tiny-guard-8m-en-response-safety-law-binary-guardset](https://huggingface.co/enguard/tiny-guard-8m-en-response-safety-law-binary-guardset) | 0.8955 | 0.7595 | 0.8219 |
|
| 170 |
-
| general-safety-education-binary | [enguard/small-guard-32m-en-general-safety-education-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-general-safety-education-binary-guardset) | 0.9835 | 0.9183 | 0.9498 |
|
| 171 |
-
| general-safety-hr-binary | [enguard/small-guard-32m-en-general-safety-hr-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-general-safety-hr-binary-guardset) | 0.9868 | 0.9322 | 0.9587 |
|
| 172 |
-
| general-safety-social-media-binary | [enguard/small-guard-32m-en-general-safety-social-media-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-general-safety-social-media-binary-guardset) | 0.9783 | 0.9300 | 0.9535 |
|
| 173 |
-
| prompt-response-safety-binary | [enguard/small-guard-32m-en-prompt-response-safety-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-prompt-response-safety-binary-guardset) | 0.9715 | 0.9288 | 0.9497 |
|
| 174 |
-
| prompt-safety-binary | [enguard/small-guard-32m-en-prompt-safety-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-prompt-safety-binary-guardset) | 0.9730 | 0.9284 | 0.9502 |
|
| 175 |
-
| prompt-safety-cyber-binary | [enguard/small-guard-32m-en-prompt-safety-cyber-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-prompt-safety-cyber-binary-guardset) | 0.9490 | 0.8957 | 0.9216 |
|
| 176 |
-
| prompt-safety-finance-binary | [enguard/small-guard-32m-en-prompt-safety-finance-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-prompt-safety-finance-binary-guardset) | 1.0000 | 0.9879 | 0.9939 |
|
| 177 |
-
| prompt-safety-law-binary | [enguard/small-guard-32m-en-prompt-safety-law-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-prompt-safety-law-binary-guardset) | 1.0000 | 0.9314 | 0.9645 |
|
| 178 |
-
| response-safety-binary | [enguard/small-guard-32m-en-response-safety-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-response-safety-binary-guardset) | 0.9484 | 0.8550 | 0.8993 |
|
| 179 |
-
| response-safety-cyber-binary | [enguard/small-guard-32m-en-response-safety-cyber-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-response-safety-cyber-binary-guardset) | 0.9681 | 0.8630 | 0.9126 |
|
| 180 |
-
| response-safety-finance-binary | [enguard/small-guard-32m-en-response-safety-finance-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-response-safety-finance-binary-guardset) | 0.9650 | 0.8961 | 0.9293 |
|
| 181 |
-
| response-safety-law-binary | [enguard/small-guard-32m-en-response-safety-law-binary-guardset](https://huggingface.co/enguard/small-guard-32m-en-response-safety-law-binary-guardset) | 0.9298 | 0.6709 | 0.7794 |
|
| 182 |
-
| general-safety-education-binary | [enguard/medium-guard-128m-xx-general-safety-education-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-general-safety-education-binary-guardset) | 0.9806 | 0.8918 | 0.9341 |
|
| 183 |
-
| general-safety-hr-binary | [enguard/medium-guard-128m-xx-general-safety-hr-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-general-safety-hr-binary-guardset) | 0.9865 | 0.9129 | 0.9483 |
|
| 184 |
-
| general-safety-social-media-binary | [enguard/medium-guard-128m-xx-general-safety-social-media-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-general-safety-social-media-binary-guardset) | 0.9690 | 0.9452 | 0.9570 |
|
| 185 |
-
| prompt-response-safety-binary | [enguard/medium-guard-128m-xx-prompt-response-safety-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-response-safety-binary-guardset) | 0.9595 | 0.9197 | 0.9392 |
|
| 186 |
-
| prompt-safety-binary | [enguard/medium-guard-128m-xx-prompt-safety-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-safety-binary-guardset) | 0.9676 | 0.9321 | 0.9495 |
|
| 187 |
-
| prompt-safety-cyber-binary | [enguard/medium-guard-128m-xx-prompt-safety-cyber-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-safety-cyber-binary-guardset) | 0.9558 | 0.8663 | 0.9088 |
|
| 188 |
-
| prompt-safety-finance-binary | [enguard/medium-guard-128m-xx-prompt-safety-finance-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-safety-finance-binary-guardset) | 1.0000 | 0.9909 | 0.9954 |
|
| 189 |
-
| prompt-safety-law-binary | [enguard/medium-guard-128m-xx-prompt-safety-law-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-safety-law-binary-guardset) | 0.9890 | 0.8824 | 0.9326 |
|
| 190 |
-
| response-safety-binary | [enguard/medium-guard-128m-xx-response-safety-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-response-safety-binary-guardset) | 0.9279 | 0.8632 | 0.8944 |
|
| 191 |
-
| response-safety-cyber-binary | [enguard/medium-guard-128m-xx-response-safety-cyber-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-response-safety-cyber-binary-guardset) | 0.9607 | 0.8837 | 0.9206 |
|
| 192 |
-
| response-safety-finance-binary | [enguard/medium-guard-128m-xx-response-safety-finance-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-response-safety-finance-binary-guardset) | 0.9381 | 0.8864 | 0.9115 |
|
| 193 |
-
| response-safety-law-binary | [enguard/medium-guard-128m-xx-response-safety-law-binary-guardset](https://huggingface.co/enguard/medium-guard-128m-xx-response-safety-law-binary-guardset) | 0.9194 | 0.7215 | 0.8085 |
|
| 194 |
-
|
| 195 |
-
## Resources
|
| 196 |
-
|
| 197 |
-
- Awesome AI Guardrails: <https://github.com/enguard-ai/awesome-ai-guardails>
|
| 198 |
-
- Model2Vec: https://github.com/MinishLab/model2vec
|
| 199 |
-
- Docs: https://minish.ai/packages/model2vec/introduction
|
| 200 |
|
| 201 |
-
##
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 202 |
|
| 203 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 204 |
|
|
|
|
| 205 |
```
|
| 206 |
@software{minishlab2024model2vec,
|
| 207 |
author = {Stephan Tulkens and {van Dongen}, Thomas},
|
|
|
|
| 1 |
---
|
| 2 |
+
base_model: unknown
|
|
|
|
|
|
|
| 3 |
library_name: model2vec
|
| 4 |
license: mit
|
| 5 |
+
model_name: tmps5qp1clz
|
| 6 |
tags:
|
| 7 |
+
- embeddings
|
| 8 |
- static-embeddings
|
| 9 |
+
- sentence-transformers
|
|
|
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# tmps5qp1clz Model Card
|
|
|
|
|
|
|
| 13 |
|
| 14 |
+
This [Model2Vec](https://github.com/MinishLab/model2vec) model is a distilled version of the unknown(https://huggingface.co/unknown) Sentence Transformer. It uses static embeddings, allowing text embeddings to be computed orders of magnitude faster on both GPU and CPU. It is designed for applications where computational resources are limited or where real-time performance is critical. Model2Vec models are the smallest, fastest, and most performant static embedders available. The distilled models are up to 50 times smaller and 500 times faster than traditional Sentence Transformers.
|
| 15 |
|
| 16 |
|
| 17 |
## Installation
|
| 18 |
|
| 19 |
+
Install model2vec using pip:
|
| 20 |
+
```
|
| 21 |
+
pip install model2vec
|
| 22 |
```
|
| 23 |
|
| 24 |
## Usage
|
| 25 |
|
| 26 |
+
### Using Model2Vec
|
| 27 |
+
|
| 28 |
+
The [Model2Vec library](https://github.com/MinishLab/model2vec) is the fastest and most lightweight way to run Model2Vec models.
|
| 29 |
+
|
| 30 |
+
Load this model using the `from_pretrained` method:
|
| 31 |
```python
|
| 32 |
+
from model2vec import StaticModel
|
| 33 |
+
|
| 34 |
+
# Load a pretrained Model2Vec model
|
| 35 |
+
model = StaticModel.from_pretrained("tmps5qp1clz")
|
| 36 |
+
|
| 37 |
+
# Compute text embeddings
|
| 38 |
+
embeddings = model.encode(["Example sentence"])
|
| 39 |
+
```
|
| 40 |
|
| 41 |
+
### Using Sentence Transformers
|
|
|
|
|
|
|
| 42 |
|
| 43 |
+
You can also use the [Sentence Transformers library](https://github.com/UKPLab/sentence-transformers) to load and use the model:
|
| 44 |
|
| 45 |
+
```python
|
| 46 |
+
from sentence_transformers import SentenceTransformer
|
| 47 |
|
| 48 |
+
# Load a pretrained Sentence Transformer model
|
| 49 |
+
model = SentenceTransformer("tmps5qp1clz")
|
| 50 |
|
| 51 |
+
# Compute text embeddings
|
| 52 |
+
embeddings = model.encode(["Example sentence"])
|
| 53 |
```
|
| 54 |
|
| 55 |
+
### Distilling a Model2Vec model
|
| 56 |
+
|
| 57 |
+
You can distill a Model2Vec model from a Sentence Transformer model using the `distill` method. First, install the `distill` extra with `pip install model2vec[distill]`. Then, run the following code:
|
| 58 |
+
|
| 59 |
+
```python
|
| 60 |
+
from model2vec.distill import distill
|
| 61 |
+
|
| 62 |
+
# Distill a Sentence Transformer model, in this case the BAAI/bge-base-en-v1.5 model
|
| 63 |
+
m2v_model = distill(model_name="BAAI/bge-base-en-v1.5", pca_dims=256)
|
| 64 |
+
|
| 65 |
+
# Save the model
|
| 66 |
+
m2v_model.save_pretrained("m2v_model")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 67 |
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 68 |
|
| 69 |
+
## How it works
|
| 70 |
+
|
| 71 |
+
Model2vec creates a small, fast, and powerful model that outperforms other static embedding models by a large margin on all tasks we could find, while being much faster to create than traditional static embedding models such as GloVe. Best of all, you don't need any data to distill a model using Model2Vec.
|
| 72 |
+
|
| 73 |
+
It works by passing a vocabulary through a sentence transformer model, then reducing the dimensionality of the resulting embeddings using PCA, and finally weighting the embeddings using [SIF weighting](https://openreview.net/pdf?id=SyK00v5xx). During inference, we simply take the mean of all token embeddings occurring in a sentence.
|
| 74 |
+
|
| 75 |
+
## Additional Resources
|
| 76 |
|
| 77 |
+
- [Model2Vec Repo](https://github.com/MinishLab/model2vec)
|
| 78 |
+
- [Model2Vec Base Models](https://huggingface.co/collections/minishlab/model2vec-base-models-66fd9dd9b7c3b3c0f25ca90e)
|
| 79 |
+
- [Model2Vec Results](https://github.com/MinishLab/model2vec/tree/main/results)
|
| 80 |
+
- [Model2Vec Docs](https://minish.ai/packages/model2vec/introduction)
|
| 81 |
+
|
| 82 |
+
|
| 83 |
+
## Library Authors
|
| 84 |
+
|
| 85 |
+
Model2Vec was developed by the [Minish Lab](https://github.com/MinishLab) team consisting of [Stephan Tulkens](https://github.com/stephantul) and [Thomas van Dongen](https://github.com/Pringled).
|
| 86 |
+
|
| 87 |
+
## Citation
|
| 88 |
|
| 89 |
+
Please cite the [Model2Vec repository](https://github.com/MinishLab/model2vec) if you use this model in your work.
|
| 90 |
```
|
| 91 |
@software{minishlab2024model2vec,
|
| 92 |
author = {Stephan Tulkens and {van Dongen}, Thomas},
|
pipeline.skops
CHANGED
|
@@ -1,3 +1,3 @@
|
|
| 1 |
version https://git-lfs.github.com/spec/v1
|
| 2 |
-
oid sha256:
|
| 3 |
size 5619450
|
|
|
|
| 1 |
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:82aa9b4009b690c65b1875a42657417835f3e81825f748b300ec4ea638cd7bad
|
| 3 |
size 5619450
|