Instructions to use NeuML/hgbert-small-embeddings with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- sentence-transformers
How to use NeuML/hgbert-small-embeddings with sentence-transformers:
from sentence_transformers import SentenceTransformer model = SentenceTransformer("NeuML/hgbert-small-embeddings") sentences = [ "That is a happy person", "That is a happy dog", "That is a very happy person", "Today is a sunny day" ] embeddings = model.encode(sentences) similarities = model.similarity(embeddings, embeddings) print(similarities.shape) # [4, 4] - Transformers
How to use NeuML/hgbert-small-embeddings with Transformers:
# Load model directly from transformers import AutoTokenizer, AutoModel tokenizer = AutoTokenizer.from_pretrained("NeuML/hgbert-small-embeddings") model = AutoModel.from_pretrained("NeuML/hgbert-small-embeddings", device_map="auto") - Notebooks
- Google Colab
- Kaggle
H.G. BERT Embeddings
This is a H.G. BERT Small model fined-tuned using sentence-transformers. It maps sentences & paragraphs to a 384 dimensional dense vector space and can be used for tasks like clustering or semantic search.
The training dataset was generating using a random sample of Historical English Books title-abstract pairs and query-sentences pairs.
This model was trained using the following three step process.
- Train an initial model using MultipleNegativesRankingLoss
- Mine hard negatives using the initial model
- Train a new model using the generated dataset with hard negatives
Unlike other models in this small domain model series, this model did not use distillation. This prevents against data leakage and learning modern similarity patterns. This keeps the model focused on 1899 and prior.
Usage (txtai)
This model can be used to build embeddings databases with txtai for semantic search and/or as a knowledge source for retrieval augmented generation (RAG).
import txtai
embeddings = txtai.Embeddings(path="neuml/hgbert-small-embeddings", content=True)
embeddings.index(documents())
# Run a query
embeddings.search("query to run")
Usage (Sentence-Transformers)
Alternatively, the model can be loaded with sentence-transformers.
from sentence_transformers import SentenceTransformer
sentences = ["This is an example sentence", "Each sentence is converted"]
model = SentenceTransformer("neuml/hgbert-small-embeddings")
embeddings = model.encode(sentences)
print(embeddings)
Usage (Hugging Face Transformers)
The model can also be used directly with Transformers.
from transformers import AutoTokenizer, AutoModel
import torch
# Mean Pooling - Take attention mask into account for correct averaging
def meanpooling(output, mask):
embeddings = output[0] # First element of model_output contains all token embeddings
mask = mask.unsqueeze(-1).expand(embeddings.size()).float()
return torch.sum(embeddings * mask, 1) / torch.clamp(mask.sum(1), min=1e-9)
# Sentences we want sentence embeddings for
sentences = ['This is an example sentence', 'Each sentence is converted']
# Load model from HuggingFace Hub
tokenizer = AutoTokenizer.from_pretrained("neuml/hgbert-small-embeddings")
model = AutoModel.from_pretrained("neuml/hgbert-small-embeddings")
# Tokenize sentences
inputs = tokenizer(sentences, padding=True, truncation=True, return_tensors='pt')
# Compute token embeddings
with torch.no_grad():
output = model(**inputs)
# Perform pooling. In this case, mean pooling.
embeddings = meanpooling(output, inputs['attention_mask'])
print("Sentence embeddings:")
print(embeddings)
Evaluation Results
A BEIR-compatible dataset was generated to facilitate the evaluation process.
Evaluation results are shown below. NDCG is used as the evaluation metric.
| Model | Parameters | NDCG | Index Time | Search Time | Disk |
|---|---|---|---|---|---|
| H.G. BERT Small Embeddings | 22.7M | 50.12 | 3.82s | 0.52s | 23 MB |
| all-MiniLM-L6-v2 | 22.7M | 44.82 | 4.50s | 0.60s | 23 MB |
| DenseOn | 149M | 47.06 | 17.52s | 1.16s | 46 MB |
| EmbeddingGemma | 300M | 47.60 | 24.47s | 2.11s | 31 MB |
| Qwen3-Embedding-0.6B | 600M | 45.75 | 27.60s | 2.98s | 62 MB |
| Qwen3-Embedding-4B | 4000M | 48.21 | 129.18s | 15.17s | 154 MB |
| Qwen3-Embedding-8B | 8000M | 47.21 | 211.95s | 24.48s | 246 MB |
This model is a solid performer at a small size. It beats all models by a comfortable margin including ones with 8 billion parameters!
It can be used in CPU-only setups without trading off much on the accuracy front. It shows how small models can excel at specialized domains, requiring less compute and disk space.
Full Model Architecture
SentenceTransformer(
(0): Transformer({'max_seq_length': 512, 'do_lower_case': False, 'architecture': 'BertModel'})
(1): Pooling({'word_embedding_dimension': 384, 'pooling_mode_cls_token': False, 'pooling_mode_mean_tokens': True, 'pooling_mode_max_tokens': False, 'pooling_mode_mean_sqrt_len_tokens': False, 'pooling_mode_weightedmean_tokens': False, 'pooling_mode_lasttoken': False, 'include_prompt': True})
)
More Information
Read more about the model in this article.
- Downloads last month
- 119
Model tree for NeuML/hgbert-small-embeddings
Base model
NeuML/hgbert-small