Instructions to use oddadmix/Emhotob-10M-Egyptian-English-v2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use oddadmix/Emhotob-10M-Egyptian-English-v2 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="oddadmix/Emhotob-10M-Egyptian-English-v2")# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("oddadmix/Emhotob-10M-Egyptian-English-v2") model = AutoModelForCausalLM.from_pretrained("oddadmix/Emhotob-10M-Egyptian-English-v2", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use oddadmix/Emhotob-10M-Egyptian-English-v2 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "oddadmix/Emhotob-10M-Egyptian-English-v2" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "oddadmix/Emhotob-10M-Egyptian-English-v2", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/oddadmix/Emhotob-10M-Egyptian-English-v2
- SGLang
How to use oddadmix/Emhotob-10M-Egyptian-English-v2 with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "oddadmix/Emhotob-10M-Egyptian-English-v2" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "oddadmix/Emhotob-10M-Egyptian-English-v2", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "oddadmix/Emhotob-10M-Egyptian-English-v2" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "oddadmix/Emhotob-10M-Egyptian-English-v2", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use oddadmix/Emhotob-10M-Egyptian-English-v2 with Docker Model Runner:
docker model run hf.co/oddadmix/Emhotob-10M-Egyptian-English-v2
Emhotob-10M-Egyptian-English-v1 โ Bidirectional Egyptian Arabic โ English (~10.9M params)
A 10.9M-parameter model that translates both ways between Egyptian colloquial Arabic (ุงูู ุตุฑูุฉ ุงูุนุงู ูุฉ) and English. A single set of weights serves both directions; a direction-specific system prompt selects which way to translate.
Finetuned from oddadmix/Emhotob-10M-v2, a tiny Llama-architecture
base (hidden 256, 4 layers, 8 heads, vocab 32000, tied embeddings).
Scaling study. This is one rung of a from-scratch Arabic scaling study that runs an identical SFT + eval recipe across bases from 0.5M to 50M parameters to locate where translation emerges. On the headline MSAโEgyptian pair, output is degenerate at โค1M, becomes real-but-rough at 5M, and usable at 10M+. See the sibling
oddadmix/50M-Egyptian-English-v1for the fluent reference.
Evaluation
Deterministic held-out set of 3,000 pairs (seed=42),
decoded greedily (do_sample=False, no repetition penalty), scored with sacreBLEU:
| Direction | sacreBLEU | chrF |
|---|---|---|
| English โ Egyptian | 10.94 | 35.73 |
| Egyptian โ English | 18.33 | 37.51 |
Saved weights are the best checkpoint by validation loss (eval_loss = 1.792). 20 samples
per direction with references are in eval_bidirectional.json.
Example translations
Real greedy-decoded outputs from the held-out set:
English โ Egyptian
| Source | Model output | Reference |
|---|---|---|
| So what should I get you? Should I get you this or that? Just imagine the scene: sitting now, wearing a sleeveless under | ุทุจ ุฃูุง ูุฌูุจูู ุฅููุ ุฃุฌูุจูู ุฅููุ ุชุฎูููุง ุงูู ูุธุฑ ุฏู: ูุนุฏูุง ุฏูููุชูุ ูุงุจุณูุง ูุฑุง ุจุนุถุ ูู ุญุชุฉ ุจุชุงูููุง ุฃุญูู ุญุชุฉ ุจุชุงุนุชูู . | ุทุจ ุฃุฌูุจ ูู ุฅููุ ุฃุฌูุจ ูู ุฏู ููุง ุฏูุ ุชุฎูู ูุฏู ุงูู ูุธุฑุ ูุงุนุฏ ุฏูููุชู ูุงุจุณ ูุงููุฉ ุจุญู ุงูุงุช ูุจุชุงูู ุฃุญูู ุญุชุฉ ูุญู ุฉ ู ู ูู ุชูููุง ูู ุญู |
| Prayer niches (mihrabs) | ุงูุบูุท (ู ุฑูุจ) | ู ุญุงุฑูุจ ุงูุตูุงุฉ |
Egyptian โ English
| Source | Model output | Reference |
|---|---|---|
| ุทุจ ุฃุฌูุจ ูู ุฅููุ ุฃุฌูุจ ูู ุฏู ููุง ุฏูุ ุชุฎูู ูุฏู ุงูู ูุธุฑุ ูุงุนุฏ ุฏูููุชู ูุงุจุณ ูุงููุฉ ุจุญู ุงูุงุช ูุจุชุงูู ุฃุญูู ุญุชุฉ ูุญู ุฉ ู ู ูู ุชูููุง ูู ุญู | So what should I get to you? Go to this, or is it? Imagine this view, sitting now wearing Van Hag's hands and eat the mo | So what should I get you? Should I get you this or that? Just imagine the scene: sitting now, wearing a sleeveless under |
| ู ุญุงุฑูุจ ุงูุตูุงุฉ | My souls | Prayer niches (mihrabs) |
Usage
ChatML format. Pick the system prompt for the direction you want:
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
model_id = "oddadmix/Emhotob-10M-Egyptian-English-v2"
tok = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, dtype=torch.bfloat16).to("cuda").eval()
SYSTEM = "ุฃูุช ู
ุชุฑุฌู
ู
ุญุชุฑู. ุชุฑุฌู
ุงููุต ุงูุฅูุฌููุฒู ุฅูู ุงูููุฌุฉ ุงูู
ุตุฑูุฉ ุงูุนุงู
ูุฉ."
def translate(text, system=SYSTEM):
prompt = (f"<|im_start|>system\n{system}<|im_end|>\n"
f"<|im_start|>user\n{text.strip()}<|im_end|>\n<|im_start|>assistant\n")
ids = tok(prompt, return_tensors="pt", add_special_tokens=False).to(model.device)
if tok.bos_token_id is not None:
bos = torch.tensor([[tok.bos_token_id]], device=model.device)
ids["input_ids"] = torch.cat([bos, ids["input_ids"]], dim=1)
ids["attention_mask"] = torch.cat([torch.ones_like(bos), ids["attention_mask"]], dim=1)
out = model.generate(**ids, max_new_tokens=256, do_sample=False,
eos_token_id=tok.eos_token_id, pad_token_id=tok.pad_token_id)
return tok.decode(out[0, ids["input_ids"].size(1):], skip_special_tokens=True).strip()
Training
- Base model:
oddadmix/Emhotob-10M-v2(Llama arch, hidden 256, 4 layers, 8 heads, vocab 32000, tied embeddings; 10,947,328 params after resizing for 2 ChatML tokens) - Dataset:
oddadmix/egyptian-translation-dataset-2.9-openai-batch - Method: HuggingFace
Trainer, ChatML, prompt-masked cross-entropy (loss only on the assistant turn). Each row is exploded into two training examples (one per direction). - Hyperparameters: 3 epochs ยท effective batch 64 ยท LR 3e-4 (cosine, 5% warmup) ยท
bf16 ยท max length 1024 ยท
load_best_model_at_endoneval_loss. - Eval split: 3,000 deterministic held-out pairs (
seed=42), scored both directions.
Out-of-domain evaluation โ Egyptian Arabic Translation Benchmark
The results above are in-domain: a held-out split of the same corpus this model was
trained on. The numbers below are out-of-domain โ the same model scored on the
Egyptian Arabic Translation Benchmark
(oddadmix/egyptian-arabic-translation-benchmark, 319 EnglishโEgyptian pairs written by a different annotator with different
orthographic conventions).
Expect these to be substantially lower than the in-domain scores. That gap is the generalization penalty, not a regression โ both numbers are real, they measure different things.
| Metric | Score |
|---|---|
BLEU (evaluate, 0โ1 โ leaderboard metric) |
0.0341 |
| BLEU (sacrebleu, 0โ100) | 3.41 |
| chrF | 31.60 |
| METEOR | 0.2235 |
Decoding is deterministic greedy (do_sample=False, no repetition penalty), using the
exact ChatML prompt format the model was trained with โ the same protocol as every other
number in this study.
Where this rung sits
| Model | Params | BLEU (hf) | BLEU (sacre) | chrF | METEOR |
|---|---|---|---|---|---|
| 5M v1 | 5.2M | 0.0000 | 0.19 | 13.00 | 0.0558 |
| 5M v2 | 5.2M | 0.0108 | 1.08 | 22.19 | 0.1352 |
| 10M v1 | 11.2M | 0.0313 | 3.13 | 28.52 | 0.1985 |
| 10M v2 (this model) | 10.9M | 0.0341 | 3.41 | 31.60 | 0.2235 |
| 25M v1 | 25.3M | 0.0991 | 9.91 | 41.07 | 0.3223 |
| 25M v2 | 25.3M | 0.0824 | 8.24 | 40.29 | 0.3148 |
| 50M v1 (bidi) | 51.8M | 0.1113 | 11.13 | 44.41 | 0.3482 |
| 50M v1 (uni) | 51.8M | 0.1261 | 12.61 | 46.13 | 0.3559 |
Reading these numbers
BLEU understates quality on this set. Scoring is against a single reference, so a correct
translation that picks a different valid word is penalized โ e.g. ูุฑูุด vs the reference's
ุทุงุฒุฉ for "fresh", or ุงูุชููููู ุงููู ุถุงุน vs ุชููููููุง ุงูุถุงูุน for "her lost phone". Both are
good Egyptian; only one matches the reference. chrF and METEOR track perceived quality more
closely here.
At 319 rows, differences of roughly 1โ2 BLEU between adjacent rungs are within noise.
These are small models โ 5M to 50M parameters, orders of magnitude below the large systems typically evaluated on this benchmark. The result of interest is the scaling curve and per-parameter efficiency, not absolute rank against models 100โ1000ร the size.
Limitations
A ~10.9M model: reliable on short/common sentences, but drift, repetition, and errors appear on long or rare inputs. Gender is disambiguated only from context. For fluent translation use the 50M sibling.
License
Apache-2.0, inherited from the base model.
- Downloads last month
- 16
Model tree for oddadmix/Emhotob-10M-Egyptian-English-v2
Base model
oddadmix/Emhotob-10M-v2