README.md

---
title: Simulateur de Déchets
emoji: ♻️
colorFrom: green
colorTo: blue
sdk: docker
app_port: 8501
tags:
  - streamlit
  - environnement
  - prédiction
  - docker
  - machine-learning
  - france
license: apache-2.0
short_description: Simulez les déchets produits par départements
pinned: true
---

# ♻️ Simulateur de production de déchets

Bienvenue sur cette application interactive Streamlit permettant de **simuler la production de déchets ménagers** en France par **département** à partir de données démographiques, économiques et environnementales.

---

## 🚀 Fonctionnalités

- Sélection d’un département
- Formulaire interactif pour modifier les données (population, activité, etc.)
- Comparaison graphique entre valeurs **observées (2019)** et **prédites**
- Visualisation dynamique des résultats

---

## 🧠 Technologies utilisées

- **Streamlit** pour l’interface utilisateur
- **Docker** pour le déploiement sur Hugging Face
- **pandas**, **numpy**, **matplotlib**, **statsmodels** pour la data science
- **pickle** pour charger les modèles
- **requests** pour accéder aux fichiers distants (modèles `.pkl` sur S3)

---

## 📦 Structure du projet

```
.
├── app/
│   └── app.py                # Script principal Streamlit
├── Dockerfile                # Image Docker pour Hugging Face
├── requirements.txt          # Dépendances Python
└── README.md                 # Ce fichier
```

---

## ⚙️ Déploiement sur Hugging Face

Ce projet est déployé sur [Hugging Face Spaces](https://huggingface.co/spaces) via l’option **SDK: Docker**.  
Le port 8501 est exposé automatiquement pour l’application Streamlit.

---

## 🔗 Liens utiles

- [Streamlit Documentation](https://docs.streamlit.io)
- [Hugging Face Spaces Documentation](https://huggingface.co/docs/hub/spaces)
- [Projet Geodechet](https://geodechet.fr) (sources des données)

---

## 📜 Licence

Distribué sous licence **Apache 2.0**.