Upload README.md with huggingface_hub

README.md

@@ -1,92 +1,157 @@
 ---
-base_model: unknown
+base_model: minishlab/potion-base-2m
+datasets:
+- Intel/polite-guard
 library_name: model2vec
 license: mit
-model_name: tmpq94ddmo_
+model_name: enguard/tiny-guard-2m-en-general-politeness-binary-intel
 tags:
-- embeddings
 - static-embeddings
-- sentence-transformers
+- text-classification
+- model2vec
 ---
 
-# tmpq94ddmo_ Model Card
+# enguard/tiny-guard-2m-en-general-politeness-binary-intel
+
+This model is a fine-tuned Model2Vec classifier based on [minishlab/potion-base-2m](https://huggingface.co/minishlab/potion-base-2m) for the general-politeness-binary found in the [Intel/polite-guard](https://huggingface.co/datasets/Intel/polite-guard) dataset.
 
-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.
 
 
 ## Installation
 
-Install model2vec using pip:
-```
-pip install model2vec
+```bash
+pip install model2vec[inference]
 ```
 
 ## Usage
 
-### Using Model2Vec
-
-The [Model2Vec library](https://github.com/MinishLab/model2vec) is the fastest and most lightweight way to run Model2Vec models.
-
-Load this model using the `from_pretrained` method:
 ```python
-from model2vec import StaticModel
+from model2vec.inference import StaticModelPipeline
 
-# Load a pretrained Model2Vec model
-model = StaticModel.from_pretrained("tmpq94ddmo_")
+model = StaticModelPipeline.from_pretrained(
+  "enguard/tiny-guard-2m-en-general-politeness-binary-intel"
+)
 
-# Compute text embeddings
-embeddings = model.encode(["Example sentence"])
-```
-
-### Using Sentence Transformers
 
-You can also use the [Sentence Transformers library](https://github.com/UKPLab/sentence-transformers) to load and use the model:
+# Supports single texts. Format input as a single text:
+text = "Example sentence"
 
-```python
-from sentence_transformers import SentenceTransformer
+model.predict([text])
+model.predict_proba([text])
 
-# Load a pretrained Sentence Transformer model
-model = SentenceTransformer("tmpq94ddmo_")
-
-# Compute text embeddings
-embeddings = model.encode(["Example sentence"])
 ```
 
-### Distilling a Model2Vec model
+## Why should you use these models?
+
+- Optimized for precision to reduce false positives.
+- Extremely fast inference: up to x500 faster than SetFit.
+
+## This model variant
+
+Below is a quick overview of the model variant and core metrics.
+
+| Field | Value |
+|---|---|
+| Classifies | general-politeness-binary |
+| Base Model | [minishlab/potion-base-2m](https://huggingface.co/minishlab/potion-base-2m) |
+| Precision | 0.9843 |
+| Recall | 0.9889 |
+| F1 | 0.9866 |
+
+### Confusion Matrix
+
+| True \ Predicted | FAIL | PASS |
+| --- | --- | --- |
+| **FAIL** | 2504 | 28 |
+| **PASS** | 40 | 7628 |
+
+<details>
+<summary><b>Full metrics (JSON)</b></summary>
+
+```json
+{
+  "FAIL": {
+    "precision": 0.9842767295597484,
+    "recall": 0.9889415481832543,
+    "f1-score": 0.9866036249014972,
+    "support": 2532.0
+  },
+  "PASS": {
+    "precision": 0.9963427377220481,
+    "recall": 0.9947835159102765,
+    "f1-score": 0.9955625163142783,
+    "support": 7668.0
+  },
+  "accuracy": 0.9933333333333333,
+  "macro avg": {
+    "precision": 0.9903097336408982,
+    "recall": 0.9918625320467653,
+    "f1-score": 0.9910830706078877,
+    "support": 10200.0
+  },
+  "weighted avg": {
+    "precision": 0.9933475286370538,
+    "recall": 0.9933333333333333,
+    "f1-score": 0.9933386032694584,
+    "support": 10200.0
+  }
+}
+```
+</details>
 
-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:
 
-```python
-from model2vec.distill import distill
+<details>
+<summary><b>Sample Predictions</b></summary>
 
-# Distill a Sentence Transformer model, in this case the BAAI/bge-base-en-v1.5 model
-m2v_model = distill(model_name="BAAI/bge-base-en-v1.5", pca_dims=256)
+| Text | True Label | Predicted Label |
+|------|------------|-----------------|
+| I appreciate your interest in our vegetarian options. I can provide you with a list of our current dishes that cater to your dietary preferences. | PASS | PASS |
+| I understand you're concerned about the ski lessons, and I'll look into the options for rescheduling. | PASS | PASS |
+| Our technical skills course will cover the essential topics in data analysis, including data visualization and statistical modeling. The course materials will be available on our learning platform. | PASS | PASS |
+| Our buffet hours are from 11 AM to 9 PM. Please note that we have a limited selection of options available during the lunch break. | PASS | PASS |
+| I'll look into your policy details and see what options are available to you. | PASS | PASS |
+| I appreciate your interest in our vegetarian options. I can provide you with a list of our current dishes that cater to your dietary preferences. | PASS | PASS |
+</details>
 
-# Save the model
-m2v_model.save_pretrained("m2v_model")
-```
 
-## How it works
+<details>
+<summary><b>Prediction Speed Benchmarks</b></summary>
 
-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.
+| Dataset Size | Time (seconds) | Predictions/Second |
+|--------------|----------------|---------------------|
+| 1 | 0.0004 | 2478.9 |
+| 1000 | 0.0557 | 17955.84 |
+| 10000 | 0.6226 | 16062.81 |
+</details>
 
-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.
 
-## Additional Resources
+## Other model variants
 
-- [Model2Vec Repo](https://github.com/MinishLab/model2vec)
-- [Model2Vec Base Models](https://huggingface.co/collections/minishlab/model2vec-base-models-66fd9dd9b7c3b3c0f25ca90e)
-- [Model2Vec Results](https://github.com/MinishLab/model2vec/tree/main/results)
-- [Model2Vec Docs](https://minish.ai/packages/model2vec/introduction)
+Below is a general overview of the best-performing models for each dataset variant.
 
+| Classifies | Model | Precision | Recall | F1 |
+| --- | --- | --- | --- | --- |
+| general-politeness-binary | [enguard/tiny-guard-2m-en-general-politeness-binary-intel](https://huggingface.co/enguard/tiny-guard-2m-en-general-politeness-binary-intel) | 0.9843 | 0.9889 | 0.9866 |
+| general-politeness-multiclass | [enguard/tiny-guard-2m-en-general-politeness-multiclass-intel](https://huggingface.co/enguard/tiny-guard-2m-en-general-politeness-multiclass-intel) | 0.9875 | 0.9704 | 0.9789 |
+| general-politeness-binary | [enguard/tiny-guard-4m-en-general-politeness-binary-intel](https://huggingface.co/enguard/tiny-guard-4m-en-general-politeness-binary-intel) | 0.9831 | 0.9878 | 0.9854 |
+| general-politeness-multiclass | [enguard/tiny-guard-4m-en-general-politeness-multiclass-intel](https://huggingface.co/enguard/tiny-guard-4m-en-general-politeness-multiclass-intel) | 0.9896 | 0.9783 | 0.9839 |
+| general-politeness-binary | [enguard/tiny-guard-8m-en-general-politeness-binary-intel](https://huggingface.co/enguard/tiny-guard-8m-en-general-politeness-binary-intel) | 0.9828 | 0.9905 | 0.9866 |
+| general-politeness-multiclass | [enguard/tiny-guard-8m-en-general-politeness-multiclass-intel](https://huggingface.co/enguard/tiny-guard-8m-en-general-politeness-multiclass-intel) | 0.9873 | 0.9795 | 0.9833 |
+| general-politeness-binary | [enguard/small-guard-32m-en-general-politeness-binary-intel](https://huggingface.co/enguard/small-guard-32m-en-general-politeness-binary-intel) | 0.9858 | 0.9889 | 0.9874 |
+| general-politeness-multiclass | [enguard/small-guard-32m-en-general-politeness-multiclass-intel](https://huggingface.co/enguard/small-guard-32m-en-general-politeness-multiclass-intel) | 0.9897 | 0.9862 | 0.9879 |
+| general-politeness-binary | [enguard/medium-guard-128m-xx-general-politeness-binary-intel](https://huggingface.co/enguard/medium-guard-128m-xx-general-politeness-binary-intel) | 0.9831 | 0.9901 | 0.9866 |
+| general-politeness-multiclass | [enguard/medium-guard-128m-xx-general-politeness-multiclass-intel](https://huggingface.co/enguard/medium-guard-128m-xx-general-politeness-multiclass-intel) | 0.9881 | 0.9870 | 0.9876 |
 
-## Library Authors
+## Resources
 
-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).
+- Awesome AI Guardrails: <https://github.com/enguard-ai/awesome-ai-guardails>
+- Model2Vec: https://github.com/MinishLab/model2vec
+- Docs: https://minish.ai/packages/model2vec/introduction
 
 ## Citation
 
-Please cite the [Model2Vec repository](https://github.com/MinishLab/model2vec) if you use this model in your work.
+If you use this model, please cite Model2Vec:
+
 ```
 @software{minishlab2024model2vec,
   author       = {Stephan Tulkens and {van Dongen}, Thomas},