Adabtranslate Darija

🚀 AdabTranslate-Darija

A state-of-the-art model for translating between Darija (Moroccan Arabic) and Modern Standard Arabic (MSA), achieving high accuracy and fluency.

🚀 Quick Start

Just copy and paste this code after installing the necessary libraries:

from transformers import AutoModelForSeq2SeqLM, AutoTokenizer

model_path = 'itsmeussa/AdabTranslate-Darija'

model = AutoModelForSeq2SeqLM.from_pretrained(model_path)

tokenizer = AutoTokenizer.from_pretrained('moussaKam/arabart')


seq = "مرحبا بيكم"
tok = tokenizer.encode(seq, return_tensors='pt')

res = model.generate(tok)
tokenizer.decode(res[0])

✨ Features

• This model is a fine - tuned version of moussaKam/arabart on an unknown dataset.
• It achieves excellent results on the evaluation set, including Loss: 1.0892, Bleu: 46.4939, and Gen Len: 9.6377.
• Trained on a diverse dataset of 26,000 text pairs, it ensures high accuracy and fluency in translating between Darija and MSA.

📦 Installation

The README does not provide specific installation steps. However, you need to install the following libraries as shown in the code example:

• Transformers 4.40.0.dev0
• Pytorch 2.2.1+cu121
• Datasets 2.18.0
• Tokenizers 0.15.2

💻 Usage Examples

Basic Usage

from transformers import AutoModelForSeq2SeqLM, AutoTokenizer

model_path = 'itsmeussa/AdabTranslate-Darija'

model = AutoModelForSeq2SeqLM.from_pretrained(model_path)

tokenizer = AutoTokenizer.from_pretrained('moussaKam/arabart')


seq = "مرحبا بيكم"
tok = tokenizer.encode(seq, return_tensors='pt')

res = model.generate(tok)
tokenizer.decode(res[0])

📚 Documentation

Model description

The Darija to MSA Translator is a state - of - the - art translation model meticulously trained on a diverse dataset comprising 26,000 text pairs meticulously annotated by human annotators and augmented using GPT - 4 techniques. Leveraging the datasets available on Hugging Face and employing advanced training techniques, this model achieves exceptional accuracy and fluency in translating between Darija (Moroccan Arabic) and Modern Standard Arabic (MSA). Powered by the Hugging Face Transformers library, it represents a significant advancement in natural language processing technology, making it a valuable tool for bridging language barriers and promoting linguistic diversity.

Intended uses & limitations

The Darija to MSA Translator is designed to cater to a wide range of users, including language enthusiasts, researchers, and developers working on multilingual projects. Its robust training on a diverse dataset ensures accuracy and effectiveness in various contexts. However, users should be aware of its limitations, particularly in highly specialized or domain - specific translations where additional fine - tuning may be necessary.

Training and evaluation data

The training data for the Darija to MSA Translator consists of 26,000 text pairs generated via human annotation and augmented using GPT - 4 techniques. These datasets were sourced from Hugging Face, ensuring a comprehensive and diverse set of examples for training. The evaluation data was carefully selected to validate the model's performance and accuracy in real - world scenarios, ensuring its reliability and effectiveness in practical applications.

Training procedure

Training hyperparameters

The following hyperparameters were used during training:

• learning_rate: 5e - 05
• train_batch_size: 16
• eval_batch_size: 16
• seed: 42
• optimizer: Adam with betas=(0.9,0.999) and epsilon = 1e - 08
• lr_scheduler_type: linear
• num_epochs: 5.0

Training results

🔧 Technical Details

The model is based on the fine - tuning of moussaKam/arabart. Advanced training techniques are used, and the training data is augmented with GPT - 4 techniques. The model is powered by the Hugging Face Transformers library.

📄 License

This model is licensed under the Apache - 2.0 license.

Authors

• Oussama Mounajjim
• Imad Zaoug
• Mehdi Soufiane