HydroSmart-BF: Agent IA pour optimisation GPL/carburant Burkina Faso avec Ollama/Qwen3.5
# 🛢️ HydroSmart-BF
**Agent Intelligent de Gestion Nationale des Hydrocarbures**
*Plateforme de prédiction et de gestion des hydrocarbures pour SONABHY - Société Nationale Burkinabè d'Hydrocarbures*
---
## 📋 Table des matières
- Présentation
- Fonctionnalités
- Architecture
- Prérequis
- Installation
- Configuration
- Utilisation
- API Documentation
- Structure du projet
- Technologies
- Contributeurs
---
## 🎯 Présentation
**HydroSmart-BF** est une solution innovante de gestion intelligente des hydrocarbures développée pour SONABHY. Le système utilise des algorithmes de Machine Learning pour prédire la demande en hydrocarbures à travers les 13 régions du Burkina Faso, optimiser les importations et prévenir les risques de pénurie.
### Mission
Assurer la sécurité énergétique du Burkina Faso par une gestion optimale des stocks d'hydrocarbures.
### Directeur Général de SONABHY
**Monsieur Seydou ZAGRE**
---
## ✨ Fonctionnalités
### 🔮 Prédiction Multi-Produits
- **Super Sans Plomb 91** - Essence automobile
- **Gasoil** - Diesel pour véhicules et générateurs
- **GPL (Gaz Butane)** - Usage domestique et industriel
- **Jet A-1** - Carburant aviation
### 📊 Analyse des Risques
- Détection précoce des risques de pénurie
- Alertes automatiques par niveau de criticité
- Recommandations d'actions correctives
### 📍 Couverture Nationale
Les 13 régions du Burkina Faso :
| Région | Chef-lieu | Population |
|--------|-----------|------------|
| Centre | Ouagadougou | 2,684,052 |
| Hauts-Bassins | Bobo-Dioulasso | 1,893,396 |
| Est | Fada N'Gourma | 1,671,543 |
| Boucle du Mouhoun | Dédougou | 1,657,000 |
| Nord | Ouahigouya | 1,554,000 |
| Centre-Ouest | Koudougou | 1,478,000 |
| Sahel | Dori | 1,346,000 |
| Centre-Est | Tenkodogo | 1,314,000 |
| Sud-Ouest | Gaoua | 827,000 |
| Plateau-Central | Ziniaré | 782,000 |
| Centre-Nord | Kaya | 1,479,000 |
| Centre-Sud | Manga | 739,000 |
| Cascades | Banfora | 790,000 |
### 🤖 Agent IA Intelligent
- Assistant conversationnel po …