AI-based early detection and risk stratification of Chronic Kidney Disease (CKD) in Benin.
# 🫀 Olanmiché — Dashboard IA pour la Maladie Rénale Chronique
> **Intelligence Artificielle au service de la détection précoce de la MRC**
> Bootcamp Cohorte 1 · Bénin · 2025
---
## 📋 Table des Matières
1. Présentation
2. Architecture du Projet
3. Installation
4. Lancement
5. Fonctionnalités du Dashboard
6. Méthodologie ML
7. Résultats
---
## 🎯 Présentation
**Olanmiché** est une application web interactive de détection et de prédiction de la **Maladie Rénale Chronique (CKD)**. Elle combine :
- 🤖 **Machine Learning** (Random Forest + Gradient Boosting)
- 📊 **Analyse exploratoire** des données cliniques
- 🗺️ **Cartographie géographique** des patients au Bénin
- 👁️ **Interprétabilité** des prédictions (SHAP approché)
- 💊 **Recommandations cliniques** personnalisées
**Performance des modèles :**
- Random Forest : F1 = 0.887 (CV 5-fold)
- Gradient Boosting : F1 = 0.897 (CV 5-fold) ⭐ Meilleur modèle
---
## 🗂️ Architecture du Projet
```
ckd_project/
│
├── app.py # 🚀 Dashboard Streamlit principal
│
├── data/
│ └── Data_AI4CKD_Original.csv # Dataset patients d'un hopital béninois
│
├── models/
│ ├── train_model.py # Script d'entraînement ML
│ ├── rf_model.pkl # Modèle Random Forest entraîné
│ ├── gb_model.pkl # Modèle Gradient Boosting entraîné
│ ├── best_model.pkl # Meilleur modèle (utilisé pour prédiction)
│ ├── metadata.json # Métriques et métadonnées des modèles
│ └── classification_report.txt
│
├── utils/
│ ├── __init__.py
│ └── preprocessing.py # Pipeline de nettoyage et feature engineering
│
├── requirements.txt # Dépendances Python
└── README.md # Ce fichier
```
---
## ⚙️ Installation
### Prérequis
- Python 3.8 ou supérieur
- pip
### Étapes
**1. Cloner ou extraire le projet**
```bash
# Si zip, extraire dans un dossier puis :
cd ckd_project
```
**2. Créer un environnement virtuel (recommandé)**
```bash
python -m venv venv
# Activer l'environ …