CoolFace
Modelpublic

aaa961/modernbert-embed-base-legal-matryoshka-2_2026-03-06

sourceHugging Faceapache-2.0updated 7mo agoView on Hugging Face
0likes24downloads
Model Card

ModernBERT Embed base Legal Matryoshka

This is a sentence-transformers model finetuned from nomic-ai/modernbert-embed-base on the json dataset. It maps sentences & paragraphs to a 768-dimensional dense vector space and can be used for semantic textual similarity, semantic search, paraphrase mining, text classification, clustering, and more.

Model Details

Model Description

  • —Model Type: Sentence Transformer
  • —Base model: nomic-ai/modernbert-embed-base <!-- at revision d556a88e332558790b210f7bdbe87da2fa94a8d8 -->
  • —Maximum Sequence Length: 8192 tokens
  • —Output Dimensionality: 768 dimensions
  • —Similarity Function: Cosine Similarity
  • —Training Dataset:
  • —json
  • —Language: en
  • —License: apache-2.0

Model Sources

Full Model Architecture

SentenceTransformer(
  (0): Transformer({'max_seq_length': 8192, 'do_lower_case': False, 'architecture': 'ModernBertModel'})
  (1): Pooling({'word_embedding_dimension': 768, '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})
  (2): Normalize()
)

Usage

Direct Usage (Sentence Transformers)

First install the Sentence Transformers library:

bash
pip install -U sentence-transformers

Then you can load this model and run inference.

python
from sentence_transformers import SentenceTransformer

# Download from the 🤗 Hub
model = SentenceTransformer("aaa961/modernbert-embed-base-legal-matryoshka-2_2026-03-06")
# Run inference
sentences = [
    'withholding of personnel data and the security of foreign intelligence activities or the protection \nof intelligence sources and methods” in order to withhold information under Exemption 3, see \nBaker v. CIA, 580 F.2d 664, 669 (D.C. Cir. 1978), the two provisions—§ 403-1(i) and § 403g—\nare often invoked together.  In the instant case, however, the CIA solely invokes § 403g as a',
    'What court case is referenced in relation to Exemption 3?',
    'What is the subject of Count Twenty in No. 11-444?',
]
embeddings = model.encode(sentences)
print(embeddings.shape)
# [3, 768]

# Get the similarity scores for the embeddings
similarities = model.similarity(embeddings, embeddings)
print(similarities)
# tensor([[1.0000, 0.5655, 0.4068],
#         [0.5655, 1.0000, 0.4290],
#         [0.4068, 0.4290, 1.0000]])

<!--

Direct Usage (Transformers)

<details><summary>Click to see the direct usage in Transformers</summary>

</details> -->

<!--

Downstream Usage (Sentence Transformers)

You can finetune this model on your own dataset.

<details><summary>Click to expand</summary>

</details> -->

<!--

Out-of-Scope Use

List how the model may foreseeably be misused and address what users ought not to do with the model. -->

Evaluation

Metrics

Information Retrieval
json
  {
      "truncate_dim": 768
  }
MetricValue
cosine_accuracy@10.4173
cosine_accuracy@30.4652
cosine_accuracy@50.5425
cosine_accuracy@100.6136
cosine_precision@10.4173
cosine_precision@30.4013
cosine_precision@50.3144
cosine_precision@100.191
cosine_recall@10.1472
cosine_recall@30.3937
cosine_recall@50.4988
cosine_recall@100.6015
cosine_ndcg@100.515
cosine_mrr@100.4611
cosine_map@1000.5042
Information Retrieval
json
  {
      "truncate_dim": 512
  }
MetricValue
cosine_accuracy@10.3972
cosine_accuracy@30.4482
cosine_accuracy@50.544
cosine_accuracy@100.6105
cosine_precision@10.3972
cosine_precision@30.3859
cosine_precision@50.3088
cosine_precision@100.1913
cosine_recall@10.1394
cosine_recall@30.3769
cosine_recall@50.4897
cosine_recall@100.5988
cosine_ndcg@100.5054
cosine_mrr@100.4462
cosine_map@1000.4914
Information Retrieval
json
  {
      "truncate_dim": 256
  }
MetricValue
cosine_accuracy@10.3709
cosine_accuracy@30.4111
cosine_accuracy@50.4946
cosine_accuracy@100.5796
cosine_precision@10.3709
cosine_precision@30.3565
cosine_precision@50.2819
cosine_precision@100.1787
cosine_recall@10.1315
cosine_recall@30.3501
cosine_recall@50.4485
cosine_recall@100.5638
cosine_ndcg@100.4716
cosine_mrr@100.4156
cosine_map@1000.4614
Information Retrieval
json
  {
      "truncate_dim": 128
  }
MetricValue
cosine_accuracy@10.323
cosine_accuracy@30.3632
cosine_accuracy@50.4374
cosine_accuracy@100.5178
cosine_precision@10.323
cosine_precision@30.3158
cosine_precision@50.2504
cosine_precision@100.1587
cosine_recall@10.1124
cosine_recall@30.3076
cosine_recall@50.397
cosine_recall@100.4985
cosine_ndcg@100.4161
cosine_mrr@100.3662
cosine_map@1000.4102
Information Retrieval
json
  {
      "truncate_dim": 64
  }
MetricValue
cosine_accuracy@10.2257
cosine_accuracy@30.2519
cosine_accuracy@50.3277
cosine_accuracy@100.3879
cosine_precision@10.2257
cosine_precision@30.2164
cosine_precision@50.1784
cosine_precision@100.1196
cosine_recall@10.0811
cosine_recall@30.2132
cosine_recall@50.2849
cosine_recall@100.3792
cosine_ndcg@100.3057
cosine_mrr@100.2607
cosine_map@1000.3026

<!--

Bias, Risks and Limitations

What are the known or foreseeable issues stemming from this model? You could also flag here known failure cases or weaknesses of the model. -->

<!--

Recommendations

What are recommendations with respect to the foreseeable issues? For example, filtering explicit content. -->

Training Details

Training Dataset

json
  • —Dataset: json
  • —Size: 5,822 training samples
  • —Columns: <code>positive</code> and <code>anchor</code>
  • —Approximate statistics based on the first 1000 samples: | | positive | anchor | |:--------|:-----------------------------------------------------------------------------------|:----------------------------------------------------------------------------------| | type | string | string | | details | <ul><li>min: 28 tokens</li><li>mean: 96.9 tokens</li><li>max: 157 tokens</li></ul> | <ul><li>min: 8 tokens</li><li>mean: 16.49 tokens</li><li>max: 46 tokens</li></ul> |
  • —Samples: | positive | anchor | |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------| | <code>its reasoning persuasive.45 <br> <br>44 The third case cited by the CIA, ACLU v. Department of Justice, 808 F. Supp. 2d 280, 288 (D.D.C. 2011), which <br>is from this Circuit, held that the CIA could withhold “whether the CIA cooperates with, is interested in, or actually</code> | <code>What court is ACLU v. Department of Justice associated with?</code> | | <code>summary judgment regarding the majority of the CIA’s invocations of the attorney-client <br>privilege. First, in both Nos. 11-445 and 11-444, the repeated and carefully circumscribed <br>statement that communications “relate to matters for which attorneys provide legal advice,” see, <br>e.g., First Lutz Decl. ¶ 79; Third Lutz Decl. ¶ 37, does not necessarily support the conclusion that</code> | <code>In which case numbers did the statement about communications appear?</code> | | <code>entirely from receiving IDIQ contract awards.16 AR at 1113–14, 2153–54, 2644–45. In other <br>words, the Solicitations force GSA to choose winners and losers.17 Yet, Plaintiffs suggest that the <br>self-scoring structure of the Polaris Solicitations eliminates the competitive nature of the <br>procurement. See, e.g., SHS MJAR at 21–22 (“[T]o the extent ‘competing offers’ even exist[], [it]</code> | <code>On which pages is the statement about Solicitations found besides 1113–14?</code> |
  • —Loss: <code>MatryoshkaLoss</code> with these parameters:
json
  {
      "loss": "MultipleNegativesRankingLoss",
      "matryoshka_dims": [
          768,
          512,
          256,
          128,
          64
      ],
      "matryoshka_weights": [
          1,
          1,
          1,
          1,
          1
      ],
      "n_dims_per_step": -1
  }

Training Hyperparameters

Non-Default Hyperparameters
  • —per_device_train_batch_size: 32
  • —num_train_epochs: 4
  • —learning_rate: 2e-05
  • —lr_scheduler_type: cosine
  • —warmup_steps: 500
  • —optim: adamwtorchfused
  • —gradient_accumulation_steps: 16
  • —bf16: True
  • —tf32: True
  • —eval_strategy: epoch
  • —per_device_eval_batch_size: 16
  • —load_best_model_at_end: True
  • —batch_sampler: no_duplicates
All Hyperparameters

<details><summary>Click to expand</summary>

  • —per_device_train_batch_size: 32
  • —num_train_epochs: 4
  • —max_steps: -1
  • —learning_rate: 2e-05
  • —lr_scheduler_type: cosine
  • —lr_scheduler_kwargs: None
  • —warmup_steps: 500
  • —optim: adamwtorchfused
  • —optim_args: None
  • —weight_decay: 0.0
  • —adam_beta1: 0.9
  • —adam_beta2: 0.999
  • —adam_epsilon: 1e-08
  • —optim_target_modules: None
  • —gradient_accumulation_steps: 16
  • —average_tokens_across_devices: True
  • —max_grad_norm: 1.0
  • —label_smoothing_factor: 0.0
  • —bf16: True
  • —fp16: False
  • —bf16_full_eval: False
  • —fp16_full_eval: False
  • —tf32: True
  • —gradient_checkpointing: False
  • —gradient_checkpointing_kwargs: None
  • —torch_compile: False
  • —torch_compile_backend: None
  • —torch_compile_mode: None
  • —use_liger_kernel: False
  • —liger_kernel_config: None
  • —use_cache: False
  • —neftune_noise_alpha: None
  • —torch_empty_cache_steps: None
  • —auto_find_batch_size: False
  • —log_on_each_node: True
  • —logging_nan_inf_filter: True
  • —include_num_input_tokens_seen: no
  • —log_level: passive
  • —log_level_replica: warning
  • —disable_tqdm: False
  • —project: huggingface
  • —trackio_space_id: trackio
  • —eval_strategy: epoch
  • —per_device_eval_batch_size: 16
  • —prediction_loss_only: True
  • —eval_on_start: False
  • —eval_do_concat_batches: True
  • —eval_use_gather_object: False
  • —eval_accumulation_steps: None
  • —include_for_metrics: []
  • —batch_eval_metrics: False
  • —save_only_model: False
  • —save_on_each_node: False
  • —enable_jit_checkpoint: False
  • —push_to_hub: False
  • —hub_private_repo: None
  • —hub_model_id: None
  • —hub_strategy: every_save
  • —hub_always_push: False
  • —hub_revision: None
  • —load_best_model_at_end: True
  • —ignore_data_skip: False
  • —restore_callback_states_from_checkpoint: False
  • —full_determinism: False
  • —seed: 42
  • —data_seed: None
  • —use_cpu: False
  • —accelerator_config: {'splitbatches': False, 'dispatchbatches': None, 'evenbatches': True, 'useseedablesampler': True, 'nonblocking': False, 'gradientaccumulationkwargs': None}
  • —parallelism_config: None
  • —dataloader_drop_last: False
  • —dataloader_num_workers: 0
  • —dataloader_pin_memory: True
  • —dataloader_persistent_workers: False
  • —dataloader_prefetch_factor: None
  • —remove_unused_columns: True
  • —label_names: None
  • —train_sampling_strategy: random
  • —length_column_name: length
  • —ddp_find_unused_parameters: None
  • —ddp_bucket_cap_mb: None
  • —ddp_broadcast_buffers: False
  • —ddp_backend: None
  • —ddp_timeout: 1800
  • —fsdp: []
  • —fsdp_config: {'minnumparams': 0, 'xla': False, 'xlafsdpv2': False, 'xlafsdpgrad_ckpt': False}
  • —deepspeed: None
  • —debug: []
  • —skip_memory_metrics: True
  • —do_predict: False
  • —resume_from_checkpoint: None
  • —warmup_ratio: None
  • —local_rank: -1
  • —prompts: None
  • —batch_sampler: no_duplicates
  • —multi_dataset_batch_sampler: proportional
  • —router_mapping: {}
  • —learning_rate_mapping: {}

</details>

Training Logs

EpochStepTraining Lossdim_768_cosine_ndcg@10dim_512_cosine_ndcg@10dim_256_cosine_ndcg@10dim_128_cosine_ndcg@10dim_64_cosine_ndcg@10
0.8791107.3885-----
1.012-0.44880.44380.42090.36490.2545
1.7033207.2784-----
2.024-0.46790.45850.43310.37200.2629
2.5275306.6649-----
3.036-0.49010.48060.45250.39480.2784
3.3516406.2111-----
4.048-0.5150.50540.47160.41610.3057
  • —The bold row denotes the saved checkpoint.

Framework Versions

  • —Python: 3.12.11
  • —Sentence Transformers: 5.2.3
  • —Transformers: 5.3.0
  • —PyTorch: 2.5.1+cu121
  • —Accelerate: 1.13.0
  • —Datasets: 4.6.1
  • —Tokenizers: 0.22.2

Citation

BibTeX

Sentence Transformers
bibtex
@inproceedings{reimers-2019-sentence-bert,
    title = "Sentence-BERT: Sentence Embeddings using Siamese BERT-Networks",
    author = "Reimers, Nils and Gurevych, Iryna",
    booktitle = "Proceedings of the 2019 Conference on Empirical Methods in Natural Language Processing",
    month = "11",
    year = "2019",
    publisher = "Association for Computational Linguistics",
    url = "https://arxiv.org/abs/1908.10084",
}
MatryoshkaLoss
bibtex
@misc{kusupati2024matryoshka,
    title={Matryoshka Representation Learning},
    author={Aditya Kusupati and Gantavya Bhatt and Aniket Rege and Matthew Wallingford and Aditya Sinha and Vivek Ramanujan and William Howard-Snyder and Kaifeng Chen and Sham Kakade and Prateek Jain and Ali Farhadi},
    year={2024},
    eprint={2205.13147},
    archivePrefix={arXiv},
    primaryClass={cs.LG}
}
MultipleNegativesRankingLoss
bibtex
@misc{henderson2017efficient,
    title={Efficient Natural Language Response Suggestion for Smart Reply},
    author={Matthew Henderson and Rami Al-Rfou and Brian Strope and Yun-hsuan Sung and Laszlo Lukacs and Ruiqi Guo and Sanjiv Kumar and Balint Miklos and Ray Kurzweil},
    year={2017},
    eprint={1705.00652},
    archivePrefix={arXiv},
    primaryClass={cs.CL}
}

<!--

Glossary

Clearly define terms in order to be accessible across audiences. -->

<!--

Model Card Authors

Lists the people who create the model card, providing recognition and accountability for the detailed work that goes into its construction. -->

<!--

Model Card Contact

Provides a way for people who have updates to the Model Card, suggestions, or questions, to contact the Model Card authors. -->