AI-generated French → Arabic transliteration dictionary for Tunisian first/last names, with a small Python library and CLI. Unverified (LLM-generated) — validate before critical use.
# nom-ar-dict
Dictionnaire de translittération **français → arabe** pour les noms de
famille et prénoms tunisiens, avec un petit outil Python pour l'utiliser.
Pensé pour les développeurs qui traitent des noms tunisiens saisis en
français/latin (formulaires, bases de données, exports) et ont besoin d'une
romanisation vers l'arabe — sans dépendance externe, juste la stdlib Python.
## ⚠️ Ce que ce dictionnaire n'est pas
**Ce n'est pas une source vérifiée.** Le dictionnaire (`data/dict_noms_ar.csv`,
7685 mots) a été **entièrement généré par un modèle d'IA** (Claude Sonnet 5) —
il n'a pas été extrait d'une base linguistique ou d'un état civil, et n'a pas
été relu mot à mot par un locuteur natif. Les mots isolés proviennent de
l'analyse d'environ 20 000 noms de médecins tunisiens réels, mais **seuls les
mots isolés sont publiés ici** — aucun nom de personne, aucune donnée
médicale.
Chaque entrée porte un niveau de confiance (`confidence`) :
| Confiance | Part du dictionnaire | Signification |
|---|---|---|
| `high` | 14.8 % (1134 mots) | Noms très courants (Mohamed, Fatma, Ben...), traduction quasi certaine |
| `medium` | 23.5 % (1806 mots) | Traduction plausible, variantes possibles |
| `low` | 61.7 % (4745 mots) | Estimation IA non vérifiée — **à valider avant usage** |
**Ne pas utiliser tel quel pour un usage critique** (état civil, documents
officiels, actes juridiques) sans vérification par un locuteur natif ou une
source faisant autorité.
## Installation
```bash
git clone
cd nom-ar-dict
pip install -e .
```
Aucune dépendance externe requise (stdlib Python uniquement, `pytest` en dev
seulement).
## Utilisation
```python
from nom_ar_dict import translate_name
result = translate_name("MOHAMED BEN ALI")
print(result["translated"]) # محمد بن علي
print(result["confidence"]) # high
```
En ligne de commande :
```bash
python -m nom_ar_dict "MOHAMED BEN ALI"
# MOHAMED BEN ALI -> محمد بن علي
# Confiance: high
python -m nom_ar_dict "ABBES-KRICHEN" --json
``` …