360TechEnv commited on
Commit
52f5ead
·
verified ·
1 Parent(s): 6559561

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +81 -0
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.