basma-cin / README.md
pixelia's picture
Vitrine Basma-CIN : présentation, licence, formulaire (sans modèles)
a86d97f verified
|
Raw History Blame Contribute Delete
6.18 kB
---
language:
- fr
- ar
license: other
license_name: basma-licence-commerciale
license_link: https://huggingface.co/pixelia/basma-cin/blob/main/LICENCE.md
pipeline_tag: image-to-text
tags:
- ocr
- mrz
- icao-9303
- identity-document
- kyc
- morocco
- on-premise
extra_gated_heading: "Demander l'accès à Basma-CIN"
extra_gated_description: "Basma-CIN est distribué uniquement sous licence commerciale. Décrivez votre projet : nous revenons vers vous pour une évaluation ou un contrat."
extra_gated_button_content: "Envoyer la demande"
extra_gated_prompt: "En envoyant cette demande, vous acceptez les conditions de LICENCE.md. Aucun usage commercial ni en production n'est autorisé sans contrat signé."
extra_gated_fields:
Nom et prénom: text
Société: text
Fonction: text
E-mail professionnel: text
Téléphone: text
Pays: country
Usage envisagé:
type: select
options:
- Évaluation technique
- KYC / ouverture de compte
- Crédit / assurance
- Administration
- Autre
Volume mensuel estimé de CIN: text
Déploiement souhaité:
type: select
options:
- Sur nos serveurs (on-premise)
- Service hébergé (API)
- À définir
J'accepte la licence et l'interdiction de redistribution: checkbox
model-index:
- name: Basma-CIN v1
results:
- task:
type: image-to-text
name: Lecture de CIN marocaines (6 champs critiques)
dataset:
type: private
name: Test gelé — 435 cartes jamais vues
metrics:
- type: precision
name: Précision des cartes acceptées
value: 99.72
- type: coverage
name: Cartes acceptées sans relecture
value: 83.0
- type: accuracy
name: Cartes entièrement justes
value: 92.4
---
# Basma-CIN
**Basma** (بصمة, « empreinte ») lit les **cartes nationales d'identité marocaines**, anciennes et
récentes, dans des PDF ou des images, **entièrement en local : aucun modèle de langage, aucun appel
réseau, aucune donnée qui sort de vos serveurs**. Pour chaque carte, Basma dit si elle peut être acceptée
telle quelle ou si une personne doit la relire.
| | |
|---|---|
| **Cartes acceptées automatiquement** | **83 %** |
| **Précision des cartes acceptées** | **99,7 %** (360 / 361) |
| Cartes entièrement justes, acceptées ou non | 92,4 % |
| Temps par dossier | ~1,3 s sur carte graphique (médiane) |
| Empreinte | ~50 Mo de modèles, aucune dépendance en ligne |
*Mesuré une seule fois, le 12/11/2026, sur 435 cartes que le modèle n'a jamais vues.*
> **Accès sur licence commerciale uniquement.** Ce dépôt est une présentation : il ne contient aucun
> modèle. Pour une évaluation ou un contrat, utilisez le formulaire **« Demander l'accès »**.
> Toutes les images de cette page sont des **spécimens synthétiques** (identité inventée, MRZ fictive).
> Aucune pièce d'identité réelle n'est publiée.
## Ce que Basma rend
Les **6 champs critiques** (n° CIN, nom, prénom, date de naissance, date d'expiration, sexe), les champs
secondaires (lieu de naissance, filiation, adresse, n° d'état civil, n° de carte, CAN), la MRZ, et une
**décision par carte** :
- **ACCEPTÉE** : les six champs critiques sont prouvés ou recoupés ; utilisable sans relecture.
- **À VÉRIFIER** : toutes les valeurs sont proposées, mais au moins un champ n'a qu'une lecture ; une
personne relit ce champ.
- **NON RECEVABLE** : scan trop petit ou recto manquant ; le document est à refaire.
Chaque champ porte un statut, sa valeur et sa confiance :
![Légende](images/legende.png)
### Carte récente : la MRZ fait foi
Les clés de contrôle **ICAO 9303** de la MRZ prouvent le n° CIN, les dates, le sexe et le nom ; le recto
doit dire la même chose.
![Carte récente, recto](images/v2_recto.png)
![Carte récente, verso](images/v2_verso.png)
### Ancienne carte : des recoupements
Sans MRZ, un champ est **prouvé** quand le recto et le verso concordent, **recoupé** quand plusieurs
lecteurs indépendants s'accordent. Un champ **lu une fois** envoie la carte en vérification, avec sa
valeur proposée.
![Ancienne carte, recto](images/v1_recto.png)
![Ancienne carte, verso](images/v1_verso.png)
## Résultats par champ (test gelé, 435 cartes)
| Champ | Précision | Rappel |
|---|---|---|
| n° CIN | 99,3 % | 96,8 % |
| nom | 98,1 % | 95,6 % |
| prénom | 98,3 % | 95,8 % |
| date de naissance | 98,8 % | 96,6 % |
| date d'expiration | 98,8 % | 96,6 % |
| sexe | 99,8 % | 97,5 % |
*Toutes cartes confondues. La précision des cartes **acceptées** (99,7 %) est plus haute : c'est le rôle
de la décision.* MRZ exactes : 96,3 %.
**Borne basse.** 360 justes sur 361, c'est 99,7 %, mais sur cet échantillon le hasard pèse : avec 95 %
de confiance, la vraie précision est d'au moins 98,4 % (intervalle de Wilson). Sur notre jeu de mise au
point de 3 477 cartes, la précision des acceptées est de 99,2 % (borne basse 98,8 %).
## Déploiement
- **Sur vos serveurs** : moteur natif (Rust + ONNX Runtime) et étage de décision en Python ; carte
graphique recommandée, fonctionne aussi sur processeur (2 à 5 s par document).
- **Sortie** : un JSON par document (valeur, statut et confiance de chaque champ, décision, motifs).
- Les documents ne quittent jamais votre infrastructure.
## Limites connues
- **Anciennes cartes** : sans MRZ, environ un quart part en vérification (les valeurs restent proposées).
- Optimisé pour les **scans et photocopies** ; les photos au téléphone ne sont pas encore mesurées.
- Cartes de séjour et cartes expirées : pas encore de traitement dédié.
## Données personnelles
Basma traite des pièces d'identité. Le traitement est local et doit respecter la **loi 09-08** et les
autorisations de la **CNDP**. Aucune donnée d'entraînement n'est publiée ni distribuée.
## Licence et contact
Logiciel propriétaire, **tous droits réservés** : voir [LICENCE.md](LICENCE.md). Évaluation, licence
commerciale ou intégration : formulaire **« Demander l'accès »** en haut de cette page.