Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
tags:
|
| 4 |
+
- waste-classification
|
| 5 |
+
- computer-vision
|
| 6 |
+
- streamlit
|
| 7 |
+
- tensorflow
|
| 8 |
+
- keras
|
| 9 |
+
library_name: tensorflow
|
| 10 |
+
---
|
| 11 |
+
|
| 12 |
+
# Interface de classification de déchets
|
| 13 |
+
|
| 14 |
+
Interface Streamlit pour la classification de déchets utilisant des modèles de deep learning entraînés.
|
| 15 |
+
|
| 16 |
+
## 🎯 Description
|
| 17 |
+
|
| 18 |
+
Cette application permet de classifier des images de déchets en deux catégories :
|
| 19 |
+
- **Papier** : Journaux, cartons, papiers divers
|
| 20 |
+
- **Plastique** : Bouteilles, emballages, objets en plastique
|
| 21 |
+
|
| 22 |
+
## 🚀 Utilisation
|
| 23 |
+
|
| 24 |
+
### Avec Docker (Recommandé)
|
| 25 |
+
|
| 26 |
+
```bash
|
| 27 |
+
# Cloner le repository
|
| 28 |
+
git clone https://huggingface.co/360TechEnv/waste-classifier
|
| 29 |
+
cd waste-classifier
|
| 30 |
+
|
| 31 |
+
# Construire et lancer avec Docker
|
| 32 |
+
docker-compose up --build -d
|
| 33 |
+
```
|
| 34 |
+
|
| 35 |
+
### Installation locale
|
| 36 |
+
|
| 37 |
+
```bash
|
| 38 |
+
# Installer les dépendances
|
| 39 |
+
pip install -r requirements.txt
|
| 40 |
+
|
| 41 |
+
# Lancer l'application
|
| 42 |
+
streamlit run app.py
|
| 43 |
+
```
|
| 44 |
+
|
| 45 |
+
## 📊 Modèles disponibles
|
| 46 |
+
|
| 47 |
+
- **waste_classifier_v1.h5** : Modèle v1 (architecture de base)
|
| 48 |
+
- **waste_classifier_v2.h5** : Modèle v2 (architecture améliorée)
|
| 49 |
+
|
| 50 |
+
## 🔧 Configuration
|
| 51 |
+
|
| 52 |
+
Les modèles sont automatiquement téléchargés au premier lancement. Vous pouvez aussi configurer des URLs personnalisées :
|
| 53 |
+
|
| 54 |
+
```bash
|
| 55 |
+
export MODEL_V1_URL="https://huggingface.co/360TechEnv/waste-classifier/resolve/main/models/waste_classifier_v1.h5"
|
| 56 |
+
export MODEL_V2_URL="https://huggingface.co/360TechEnv/waste-classifier/resolve/main/models/waste_classifier_v2.h5"
|
| 57 |
+
```
|
| 58 |
+
|
| 59 |
+
## 📈 Performance
|
| 60 |
+
|
| 61 |
+
- **Modèle v1** : Précision ~54%
|
| 62 |
+
- **Modèle v2** : Précision améliorée
|
| 63 |
+
|
| 64 |
+
## 🛠️ Technologies
|
| 65 |
+
|
| 66 |
+
- **Streamlit** : Interface utilisateur
|
| 67 |
+
- **TensorFlow/Keras** : Modèles de deep learning
|
| 68 |
+
- **OpenCV/PIL** : Traitement d'images
|
| 69 |
+
- **Docker** : Containerisation
|
| 70 |
+
|
| 71 |
+
## 📄 Licence
|
| 72 |
+
|
| 73 |
+
MIT License - Voir le fichier LICENSE pour plus de détails.
|
| 74 |
+
|
| 75 |
+
## 🤝 Contribution
|
| 76 |
+
|
| 77 |
+
Ce projet est open source. N'hésitez pas à contribuer ou signaler des problèmes !
|
| 78 |
+
|
| 79 |
+
## 📞 Support
|
| 80 |
+
|
| 81 |
+
Pour toute question ou problème, créez une issue sur le repository.
|