GitLab CI commited on
Commit
7dff1a7
·
1 Parent(s): aea6ab8

Déploiement Dashboard depuis GitLab CI - 2026-03-04 08:10:06

Browse files
Files changed (1) hide show
  1. README.md +14 -47
README.md CHANGED
@@ -1,58 +1,25 @@
1
  ---
2
- title: Prêt à Dépenser - API de Prédiction
3
- emoji: 💰
4
- colorFrom: blue
5
- colorTo: green
6
  sdk: docker
7
  pinned: false
8
  ---
9
 
10
- # API pour la prédiction du risque de défaillance de paiement d'un Crédit - Prêt à Dépenser
11
 
12
- Cette API permet de prédire à l'aide d'un modèle de Machine Learning (Histogramme Gradient Boosting)
13
- si un client risque d'être en défaut de paiement lors de l'analyse de sa demande de prêt.
14
 
15
- ## Endpoints disponibles
16
-
17
- - `GET /health` - Vérification de l'état de l'API
18
- - `GET /columns` - Liste des colonnes attendues par le modèle
19
- - `POST /predict` - Prédiction pour un client avec les 10 variables les plus importantes
20
- - `POST /predict/file` - Prédiction en lot avec toutes les variables via fichier CSV
21
-
22
- ## Documentation interactive
23
-
24
- Accédez à la documentation Swagger : `/docs`
25
-
26
- ## Accessibilité de l'API
27
-
28
- l'API (FastAPI) et son interface graphique (Streamlit) sont déployées sur Hugging Face Spaces (public) et accessibles via les liens suivants.
29
 
 
30
  - **Interface graphique** : https://huggingface.co/spaces/CedM/oc_mlops_projet_2_dashboard
31
- - **Ligne de commande (Linux, MacOS, Windows)** :\
32
- curl -X GET "https://cedm-oc-mlops-projet-2.hf.space/health"
33
- curl -X GET "https://cedm-oc-mlops-projet-2.hf.space/columns"
34
- curl -X POST "https://cedm-oc-mlops-projet-2.hf.space/predict" -H "Content-Type: application/json" -d '{"features": {"EXT_SOURCE_3": 0.1393757800997895, "EXT_SOURCE_2": 0.2629485927471776, "EXT_SOURCE_1": 0.0830369673913225, "DAYS_EMPLOYED": -637.0, "PAYMENT_RATE": 0.0607492667810303, "INSTAL_DPD_MEAN": 0.0, "PREV_CNT_PAYMENT_MEAN": 24.0, "AMT_ANNUITY": 24700.5, "CODE_GENDER": 0, "PREV_NAME_PRODUCT_TYPE_walk-in_MEAN": 0.0}}'
35
- curl -X POST "https://cedm-oc-mlops-projet-2.hf.space/predict/file" -F "file=@./train_data_sp2_subsample_1.csv"
36
-
37
- ## Accessibilité des données pour tester l'API et Logs
38
-
39
- - Des données de test sont disponibles dans un Hugging Face Dataset (public) : https://huggingface.co/datasets/CedM/oc_mlops_projet_2/tree/main
40
- Pour faire une demande en lot, prenez par exemple le fichier : `train_data_sp2_subsample_1.csv`
41
-
42
- - Les logs de l'API (latence, erreurs) sont accessibles au même endroit (api_log.jsonl) ainsi que l'historique des demandes/réponses de l'API (data_io.csv) pour suivre les prédictions et la dérive des données.
43
-
44
- ## Structure du projet
45
-
46
- Le projet est hébergé sur Framagit.org (public - instance GitLab) et est poussé automatiquement sur Hugging Face Spaces via GitLab CI sous forme de conteneurs Docker lors d'un PUSH sur la branche `main` de GitLab :
47
- https://framagit.org/dapa/oc_mlops_projet_2
48
-
49
- ![title](4_Docs/structure_projet.png)
50
-
51
- ## Détails de l'interface graphique (Dashboard Streamlit)
52
 
53
- Le dashboard permet de :
54
 
55
- - Faire une demande de prédiction individuelle basée sur les 10 variables les plus importantes pour la prédiction de défaut de paiement
56
- - Faire une demande en lot via un fichier CSV
57
- - Visualiser la dérive des données (Data drift - pour savoir si il est nécessaire de réentraîner le modèle)
58
- - Visualiser la latence et les erreurs de l'API
 
1
  ---
2
+ title: Prêt à Dépenser - Dashboard
3
+ emoji: 📊
4
+ colorFrom: green
5
+ colorTo: blue
6
  sdk: docker
7
  pinned: false
8
  ---
9
 
10
+ # Dashboard Streamlit - Prêt à Dépenser
11
 
12
+ Ce dashboard permet de faire via une interface graphique une prédiction de défaillance de paiement de crédit
13
+ pour un client.
14
 
15
+ ## Accessibilité du dashboard
 
 
 
 
 
 
 
 
 
 
 
 
 
16
 
17
+ Le dashboard est déployé sur Hugging Face Spaces (public) et accessible via le lien suivant :\
18
  - **Interface graphique** : https://huggingface.co/spaces/CedM/oc_mlops_projet_2_dashboard
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19
 
20
+ ## Fonctionnalités
21
 
22
+ - Demande de prédiction individuelle
23
+ - Demande en lot via fichier CSV
24
+ - Visualisation de la dérive des données
25
+ - Visualisation de la latence et des erreurs de l'API