davidberenstein1957 commited on
Commit
3351149
·
verified ·
1 Parent(s): a7c2372

Upload folder using huggingface_hub

Browse files
Files changed (3) hide show
  1. README.md +53 -97
  2. model.safetensors +1 -1
  3. pipeline.skops +2 -2
README.md CHANGED
@@ -1,136 +1,92 @@
1
  ---
2
- base_model: minishlab/potion-base-8m
3
- datasets:
4
- - google/jigsaw_toxicity_pred
5
  library_name: model2vec
6
  license: mit
7
- model_name: enguard/tiny-guard-8m-en-prompt-toxicity-binary-jigsaw
8
  tags:
 
9
  - static-embeddings
10
- - text-classification
11
- - model2vec
12
  ---
13
 
14
- # enguard/tiny-guard-8m-en-prompt-toxicity-binary-jigsaw
 
 
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 prompt-toxicity-binary found in the [google/jigsaw_toxicity_pred](https://huggingface.co/datasets/google/jigsaw_toxicity_pred) dataset.
17
 
18
  ## Installation
19
 
20
- ```bash
21
- pip install model2vec[inference]
 
22
  ```
23
 
24
  ## Usage
25
 
 
 
 
 
 
26
  ```python
27
- from model2vec.inference import StaticModelPipeline
28
 
29
- model = StaticModelPipeline.from_pretrained(
30
- "enguard/tiny-guard-8m-en-prompt-toxicity-binary-jigsaw"
31
- )
32
 
33
- model.predict(["Example sentence"])
34
- model.predict_proba(["Example sentence"])
35
  ```
36
 
37
- ## Why should you use these models?
38
-
39
- - Optimized for precision to reduce false positives.
40
- - Extremely fast inference using static embeddings powered by Model2Vec.
41
-
42
- ## This model variant
43
-
44
- Below is a quick overview of the model variant and core metrics.
45
-
46
- | Field | Value |
47
- |---|---|
48
- | Classifies | prompt-toxicity-binary |
49
- | Base Model | [minishlab/potion-base-8m](https://huggingface.co/minishlab/potion-base-8m) |
50
- | Precision | 0.9416 |
51
-
52
- <details>
53
- <summary><b>Full metrics (JSON)</b></summary>
54
-
55
- ```json
56
- {
57
- "FAIL": {
58
- "precision": 0.9415954415954416,
59
- "recall": 0.8496143958868895,
60
- "f1-score": 0.8932432432432432,
61
- "support": 1556.0
62
- },
63
- "PASS": {
64
- "precision": 0.8586102719033233,
65
- "recall": 0.9454424484364604,
66
- "f1-score": 0.8999366687777074,
67
- "support": 1503.0
68
- },
69
- "accuracy": 0.8966982674076496,
70
- "macro avg": {
71
- "precision": 0.9001028567493825,
72
- "recall": 0.8975284221616749,
73
- "f1-score": 0.8965899560104753,
74
- "support": 3059.0
75
- },
76
- "weighted avg": {
77
- "precision": 0.9008217541004255,
78
- "recall": 0.8966982674076496,
79
- "f1-score": 0.8965319711210791,
80
- "support": 3059.0
81
- }
82
- }
83
  ```
84
- </details>
85
 
 
86
 
87
- <details>
88
- <summary><b>Sample Predictions</b></summary>
89
 
90
- | Text | True Label | Predicted Label |
91
- |------|------------|-----------------|
92
- | ":::SLR Chronology bibliography is complete<br><br>Hi, MurderWatcher1. This is Paul1513 again. This is to let you know that I have completed the SLR Chronology bibliography for you and that I am going to try to upload a PDF copy to your Talk page as soon as I finish this note. This may take a while, because I've never uploaded a PDF before.<br><br>You're absolutely right; it would be great if some of the old Modern Photography stuff could be added to Wikipedia. However, you can be sure that they're still under copyright. (Pre-1978 American ""work-for-hire"" copyrights are generally 75 years; 1978 and on, 95 years.) The real question is: Who OWNS the copyright today? Since Modern went under, there have been many media company sales and resales - the present copyright holder would be hell to uncover and ask permission. In fact, the current owner might not even know that it owns Modern's copyrights. ""Orphaned"" copyrights are a major unresolved ""fair use"" issue in the information age.<br><br>Speaking of first cameras: mine was a simple Vivitar 110 point-and-shoot. My parents gave it to me for getting straight A's in the 5th grade. It was, of course, a bad camera, but it opened up a world of possibilities. From the Vivitar, I eventually learned about the existence of the Pentax Auto 110 SLR. It was then one step to 35 mm SLRs and I got a Nikon FE2 in 1983. The FE2 is also the reason why the bulk of my Modern Photography magazine citations begin around 1983.<br><br>I'm sorry to hear about your disputes with the Admins over your non-photography Wkipedia entries. It would be unfortunate if you felt compelled to end your Wikipedia activities over them. Perhaps you could start a blog or create a MySpace or Facebook page to air these issues without worrying about what the Admins want. However, I will respect whatever your decision is, as I fully understand that the most sophisticated machine is nothing next to a human life.<br><br>You can reach me on my Talk page. Thanks Muchly <br><br>" | PASS | PASS |
93
- | Are you deaf or blind? I repeat. It started in late 2009, and collapsed in mid 2010, as supported by cites and polls. | FAIL | PASS |
94
- | "<br>Thanks for your note. I've been reporting accounts like these for over a year now and they all almost always get an indefinite block since they are vandalism only accounts. Blocks are necessary in these cases as it is not known when any person behind these accounts may come back and vandalize again. I see you have again removed these reports from the noticeboard which I have to again disagree with. therefore I kindly request you to put them back on the noticeboard for another administrator to review. ~ (talk) " | PASS | PASS |
95
- | SOMEGUY1221 LIKES TO SUCK LARGE HARD PENIS. | FAIL | FAIL |
96
- | "<br>Well, you're using criteria that you have decided constitute a legitimate decision procedure for establishing whether something is Israeli. Content decisions can't be made that way here. I have a decision procedure that enables me to decide who is an idiot and yet annoyingly I am not allowed to deploy it in articles about living people who clearly meet the criteria. ''' - talk''' " | FAIL | PASS |
97
- | ":::SLR Chronology bibliography is complete<br><br>Hi, MurderWatcher1. This is Paul1513 again. This is to let you know that I have completed the SLR Chronology bibliography for you and that I am going to try to upload a PDF copy to your Talk page as soon as I finish this note. This may take a while, because I've never uploaded a PDF before.<br><br>You're absolutely right; it would be great if some of the old Modern Photography stuff could be added to Wikipedia. However, you can be sure that they're still under copyright. (Pre-1978 American ""work-for-hire"" copyrights are generally 75 years; 1978 and on, 95 years.) The real question is: Who OWNS the copyright today? Since Modern went under, there have been many media company sales and resales - the present copyright holder would be hell to uncover and ask permission. In fact, the current owner might not even know that it owns Modern's copyrights. ""Orphaned"" copyrights are a major unresolved ""fair use"" issue in the information age.<br><br>Speaking of first cameras: mine was a simple Vivitar 110 point-and-shoot. My parents gave it to me for getting straight A's in the 5th grade. It was, of course, a bad camera, but it opened up a world of possibilities. From the Vivitar, I eventually learned about the existence of the Pentax Auto 110 SLR. It was then one step to 35 mm SLRs and I got a Nikon FE2 in 1983. The FE2 is also the reason why the bulk of my Modern Photography magazine citations begin around 1983.<br><br>I'm sorry to hear about your disputes with the Admins over your non-photography Wkipedia entries. It would be unfortunate if you felt compelled to end your Wikipedia activities over them. Perhaps you could start a blog or create a MySpace or Facebook page to air these issues without worrying about what the Admins want. However, I will respect whatever your decision is, as I fully understand that the most sophisticated machine is nothing next to a human life.<br><br>You can reach me on my Talk page. Thanks Muchly <br><br>" | PASS | PASS |
98
- </details>
99
 
 
 
100
 
101
- <details>
102
- <summary><b>Prediction Speed Benchmarks</b></summary>
 
103
 
104
- | Dataset Size | Time (seconds) | Predictions/Second |
105
- |--------------|----------------|---------------------|
106
- | 1 | 0.0009 | 1061.85 |
107
- | 1000 | 0.1182 | 8457.61 |
108
- | 3059 | 0.3676 | 8322.52 |
109
- </details>
110
 
 
111
 
112
- ## Other model variants
113
 
114
- Below is a general overview of the best-performing models for each dataset variant.
115
 
116
- | Classifies | Model | P/R/F1 |
117
- | --- | --- | --- |
118
- | prompt-toxicity-binary | [enguard/tiny-guard-2m-en-prompt-toxicity-binary-jigsaw](https://huggingface.co/enguard/tiny-guard-2m-en-prompt-toxicity-binary-jigsaw) | 0.9628/0.7494/0.8428 |
119
- | prompt-toxicity-binary | [enguard/tiny-guard-4m-en-prompt-toxicity-binary-jigsaw](https://huggingface.co/enguard/tiny-guard-4m-en-prompt-toxicity-binary-jigsaw) | 0.9532/0.8252/0.8846 |
120
- | prompt-toxicity-binary | [enguard/small-guard-32m-en-prompt-toxicity-binary-jigsaw](https://huggingface.co/enguard/small-guard-32m-en-prompt-toxicity-binary-jigsaw) | 0.9507/0.8425/0.8934 |
121
- | prompt-toxicity-binary | [enguard/tiny-guard-8m-en-prompt-toxicity-binary-jigsaw](https://huggingface.co/enguard/tiny-guard-8m-en-prompt-toxicity-binary-jigsaw) | 0.9416/0.8496/0.8932 |
122
- | prompt-toxicity-binary | [enguard/medium-guard-128m-xx-prompt-toxicity-binary-jigsaw](https://huggingface.co/enguard/medium-guard-128m-xx-prompt-toxicity-binary-jigsaw) | 0.9187/0.8638/0.8904 |
123
 
124
- ## Resources
125
 
126
- - Awesome AI Guardrails: https://github.com/enguard-ai/awesome-ai-guardrails
127
- - Model2Vec: https://github.com/MinishLab/model2vec
128
- - Docs: https://minish.ai/packages/model2vec/introduction
129
 
130
- ## Citation
131
 
132
- If you use this model, please cite Model2Vec:
133
 
 
134
  ```
135
  @software{minishlab2024model2vec,
136
  author = {Stephan Tulkens and {van Dongen}, Thomas},
 
1
  ---
2
+ base_model: unknown
 
 
3
  library_name: model2vec
4
  license: mit
5
+ model_name: tmpq6p0ck6g
6
  tags:
7
+ - embeddings
8
  - static-embeddings
9
+ - sentence-transformers
 
10
  ---
11
 
12
+ # tmpq6p0ck6g 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("tmpq6p0ck6g")
 
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("tmpq6p0ck6g")
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},
model.safetensors CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:095747a667f6c6469e1ae91ea89867d9813031b82fd50e25252c4ac05f47cdee
3
  size 30591248
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:f11d258e2c73e1c5a17ab103f714d02bdd602019901614583cdcfbbdc71ed0e9
3
  size 30591248
pipeline.skops CHANGED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:002a79d0c26f52bac43fd509c71180294e64af539719d1ea3d0a94fe93277e43
3
- size 3769672
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:f1e61ab171fd812dbdf66a60bb7797bdaa3138f68285ad651968dcdbc011d1e9
3
+ size 5619450