| --- |
| license: cc-by-sa-4.0 |
| language: |
| - ar |
| base_model: |
| - U4RASD/NeoAraBERT |
| tags: |
| - neoarabert |
| - neobert |
| - bert |
| - MSA |
| - msa |
| - modern-standard-arabic |
| - Classical Arabic |
| - CA |
| - Dialect |
| - dialect |
| - masked-language-model |
| - Masked Langauge Model |
| - Arabic BERT |
| - custom_code |
| pipeline_tag: feature-extraction |
| library_name: Transformers |
| --- |
| # NeoAraBERT |
| <table align="right" style="border: none; margin-left: 28px; margin-bottom: 16px; width: 290px;"> |
| <tr style="border: none;"> |
| <td align="center" style="border: none; padding: 0; padding-top: 4px;"> |
| <img src="https://cdn-uploads.huggingface.co/production/uploads/65338533a78e70d19c850120/8ijYrACVusalZ3CIU0rk_.png" width="193.333333" style="border: none; box-shadow: none;"> |
| </td> |
| </tr> |
| <tr style="border: none;"> |
| <td align="center" style="border: none; padding: 0;"> |
| <img src="https://cdn-uploads.huggingface.co/production/uploads/65338533a78e70d19c850120/jl_hN3qIJtAm-oqlH2BXW.png" width="112" style="border: none; box-shadow: none;"> |
| </td> |
| </tr> |
| </table> |
| NeoAraBERT is a state-of-the-art open-source Arabic text-embedding model built on the NeoBERT architecture. This project was a collaboration between the Arab Center for Research and Policy Studies’ (ACRPS) Unit for Research In Arabic Social and Digital Spaces (U4RASD) and the American University of Beirut (AUB). |
| |
| We pretrain NeoAraBERT on diverse open-source and internal datasets covering modern standard, classical, and dialectal Arabic. We guided our design choices with Arabic tailored ablation studies including text normalization, light stemming, and diacritics-aware tokenization handling. We also performed POS-aware token masking and learning-rate scheduling ablation studies. We benchmarked NeoAraBERT against five top-performing Arabic models on 23 tasks, including a synonym-based task, [Muradif](https://huggingface.co/datasets/U4RASD/Muradif), that directly assesses embedding quality with no additional fine-tuning. NeoAraBERT variants rank first in 18 tasks and improve average performance across the full benchmark suite. |
|
|
| This is the **NeoAraBERT_Mix** checkpoint, our best-performing checkpoint overall. This model was introduced at the 64th Annual Meeting of the Association for Computational Linguistics (ACL 2026). For more information, visit our website: https://acr.ps/neoarabert. |
| |
| The available NeoAraBERT checkpoints: |
| | Model | Description | Link | |
| |---|---|---| |
| | NeoAraBERT (NeoAraBERT_Mix) | Trained on both Modern Standard Arabic and Dialectal Arabic. | this repository ✅ | |
| | NeoAraBERT_MSA | Trained on Modern Standard Arabic. | [link](https://huggingface.co/U4RASD/NeoAraBERT_MSA) | |
| | NeoAraBERT_DA | Trained on Dialectal Arabic. | [link](https://huggingface.co/U4RASD/NeoAraBERT_DA) | |
| |
|  |
| |
| For detailed benchmarking, see https://acr.ps/neoarabert. |
| |
| ### How to Use |
| Install these libraries: |
| ``` |
| pip install fast-disambig torch==2.5.1 transformers==4.49.0 xformers==0.0.28.post3 torchvision torchaudio |
| ``` |
| Load the model and use it to generate embeddings: |
| ```python |
| from transformers import AutoModel, AutoTokenizer |
| |
| model_name = "U4RASD/NeoAraBERT" |
| tokenizer = AutoTokenizer.from_pretrained(model_name, trust_remote_code=True) |
| model = AutoModel.from_pretrained(model_name, trust_remote_code=True) |
| |
| # Tokenize input text |
| text = "المركز العربيّ للأبحاث ودراسة السياسات." |
| inputs = tokenizer(text, return_tensors="pt") |
| |
| # Generate embeddings |
| outputs = model(**inputs) |
| embedding = outputs.last_hidden_state[:, 0, :] |
| print(embedding.shape) |
| ``` |
| |
| ### Citation |
| If you use the code, model, or the Muradif benchmark, please cite: |
| ```bibtex |
| @inproceedings{abou-chakra-etal-2026-neoarabert, |
| title = "{NeoAraBERT}: A Modern Foundation Model for Arabic Embeddings with Diacritics-Aware Tokenization and POS-Targeted Masking", |
| author = "Abou Chakra, Chadi and |
| Hamoud, Hadi and |
| Rakan Al Mraikhat, Osama and |
| Abu Obaida, Qusai and |
| Ballout, Mohamad and |
| Zaraket, Fadi A.", |
| booktitle = "Findings of the Association for Computational Linguistics: ACL 2026", |
| address = "San Diego, California, United States", |
| year = "2026", |
| note = "Accepted paper", |
| url = "https://acr.ps/neoarabert", |
| abstract = {We present NeoAraBERT, a state-of-the-art open-source Arabic text-embedding model built on the NeoBERT architecture. We pre-train NeoAraBERT on diverse open-source and internal datasets covering modern standard, classical, and dialectal Arabic. We guided our design choices with Arabic tailored ablation studies including text normalization, light stemming, and diacritics-aware tokenization handling. We also performed more general POS-aware token masking and learning-rate scheduling ablation studies. We benchmarked NeoAraBERT against five top-performing Arabic models on 23 tasks, including a novel synonym-based task, ``Muradif'', that directly assesses embedding quality with no additional fine-tuning. NeoAraBERT variants (MSA, dialectal, and mixed) rank first in 18 tasks, second in two, third in two, and fourth in one task. They show strong performance on classical and modern standard Arabic, substantial margins of improvement ($>$7\%) in two tasks, and a $+$2.75\% improvement on average across all tasks. Our code and links to checkpoints for our model variants are available on our website: \url{https://acr.ps/neoarabert}} |
| } |
| ``` |
| |
| ### Acknowledgements |
| We would like to acknowledge Ahmad Talal Salman from Assafir and Professor Amer Abdo Mouawad from the American University of Beirut for sharing Assafir data, which was instrumental to the work presented in this paper. |
|
|
| ### License |
| This model is licensed under the CC BY-SA 4.0 license. The text of the license can be found [here](https://creativecommons.org/licenses/by-sa/4.0/). |
