|
Download README.md from pixelia/basma-cin: direct link, hf CLI and curl.
- Browser
- Download file 6.18 kB
-
https://huggingface.co/pixelia/basma-cin/resolve/main/README.md
- Command line
-
hf download hf://pixelia/basma-cin/README.md
-
curl -L -H "Authorization: Bearer $HF_TOKEN" -o README.md https://huggingface.co/pixelia/basma-cin/resolve/main/README.md
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 : | |
|  | |
| ### 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. | |
|  | |
|  | |
| ### 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. | |
|  | |
|  | |
| ## 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. | |