Nadinamo commited on
Commit
2c3958a
·
verified ·
1 Parent(s): af3a418

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +392 -7
README.md CHANGED
@@ -1,14 +1,399 @@
1
  ---
2
- title: Detector Enfermedades Tomate
3
- emoji: 🏢
4
- colorFrom: blue
5
- colorTo: indigo
6
  sdk: gradio
7
- sdk_version: 5.49.1
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
- short_description: 'Diagnóstico de enfermedades en plantas de tomate '
 
 
 
 
 
 
 
 
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Detector de Enfermedades en Plantas de Tomate
3
+ emoji: 🌱
4
+ colorFrom: green
5
+ colorTo: blue
6
  sdk: gradio
7
+ sdk_version: 4.16.0
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
+ tags:
12
+ - agriculture
13
+ - computer-vision
14
+ - disease-detection
15
+ - argentina
16
+ - RAG
17
+ - plant-pathology
18
+ - agtech
19
+ - image-classification
20
  ---
21
 
22
+ # 🌱 Sistema de Diagnóstico de Enfermedades en Plantas de Tomate
23
+
24
+ <div align="center">
25
+
26
+ ![Version](https://img.shields.io/badge/version-1.0.0-green)
27
+ ![License](https://img.shields.io/badge/license-MIT-blue)
28
+ ![Python](https://img.shields.io/badge/python-3.9+-yellow)
29
+ ![Hugging Face](https://img.shields.io/badge/🤗-Hugging%20Face-orange)
30
+
31
+ **Sistema inteligente de diagnóstico de enfermedades en cultivos de tomate**
32
+ *Combinando Computer Vision + RAG + Procesamiento de Lenguaje Natural (NLP)*
33
+
34
+ [🚀 Probar Demo](#) | [📖 Documentación](#características) | [🤝 Contribuir](#contribuciones)
35
+
36
+ </div>
37
+
38
+ ---
39
+
40
+ ## 🎯 Descripción
41
+
42
+ Este sistema utiliza inteligencia artificial para diagnosticar enfermedades en plantas de tomate a partir de imágenes de hojas. Integra tres tecnologías de vanguardia:
43
+
44
+ - **🔍 Visión por Computadora**: Clasificación automática usando MobileNetV2
45
+ - **📚 RAG (Retrieval-Augmented Generation)**: Base de conocimiento agronómico con búsqueda semántica
46
+ - **🤖 NLP**: Generación de recomendaciones personalizadas para el contexto argentino
47
+
48
+ ### ¿Por qué es importante?
49
+
50
+ Las enfermedades en tomate pueden causar pérdidas de hasta **40% de la producción** en Argentina. Este sistema permite:
51
+ - ✅ Diagnóstico rápido (2-4 segundos)
52
+ - ✅ Recomendaciones específicas para Argentina
53
+ - ✅ Acceso gratuito 24/7
54
+ - ✅ Información basada en documentos técnicos de INTA
55
+
56
+ ---
57
+
58
+ ## 🚀 Características
59
+
60
+ ### 1. **Clasificación Inteligente de Enfermedades**
61
+
62
+ Detecta automáticamente **10+ enfermedades comunes**:
63
+
64
+ | Enfermedad | Agente Causal | Prevalencia en Argentina |
65
+ |------------|---------------|--------------------------|
66
+ | 🦠 Mancha Bacteriana | *Xanthomonas* spp. | Alta (Litoral) |
67
+ | 🍂 Tizón Temprano | *Alternaria solani* | Alta (NOA, Cuyo) |
68
+ | ⚠️ Tizón Tardío | *Phytophthora infestans* | Media-Alta |
69
+ | 🌫️ Moho Foliar | *Passalora fulva* | Media (invernaderos) |
70
+ | 🔴 Septoriosis | *Septoria lycopersici* | Media-Alta |
71
+ | 🕷️ Arañuela Roja | *Tetranychus urticae* | Alta (verano) |
72
+ | 🎯 Mancha Anillada | *Corynespora cassiicola* | Emergente |
73
+ | 🦟 Virus de la Cuchara | TYLCV | Presente en NOA |
74
+ | 🧬 Mosaico del Tomate | ToMV | Esporádica |
75
+ | ✅ Planta Sana | - | ¡El objetivo! |
76
+
77
+ ### 2. **Base de Conocimiento RAG**
78
+
79
+ - Documentos técnicos de **INTA** (Instituto Nacional de Tecnología Agropecuaria)
80
+ - Búsqueda semántica con embeddings multilingües
81
+ - Información contextualizada para cada región de Argentina
82
+ - Recomendaciones de productos fitosanitarios disponibles localmente
83
+
84
+ ### 3. **Interfaz Intuitiva**
85
+
86
+ - Sube una foto desde tu celular o computadora
87
+ - Obtén diagnóstico completo en segundos
88
+ - Información clara: síntomas, tratamiento y prevención
89
+ - Diseño responsive (funciona en móviles)
90
+
91
+ ---
92
+
93
+ ## 🛠️ Tecnologías Utilizadas
94
+
95
+ ### Modelos de IA
96
+
97
+ ```python
98
+ Vision: linkanjarad/mobilenet_v2_1.0_224-plant-disease-identification
99
+ NLP: google/flan-t5-small (80M parámetros)
100
+ Embeddings: paraphrase-multilingual-MiniLM-L12-v2
101
+ Vector DB: FAISS (Facebook AI Similarity Search)
102
+ ```
103
+
104
+ ### Stack Técnico
105
+
106
+ - **Framework UI**: Gradio 4.16.0
107
+ - **ML Framework**: PyTorch + Transformers
108
+ - **Embeddings**: Sentence-Transformers
109
+ - **Búsqueda**: FAISS
110
+ - **Deployment**: Hugging Face Spaces (CPU)
111
+
112
+ ---
113
+
114
+ ## 📊 Rendimiento
115
+
116
+ | Métrica | Valor |
117
+ |---------|-------|
118
+ | Precisión del modelo | ~95% (PlantVillage dataset) |
119
+ | Tiempo de inferencia | 2-4 segundos |
120
+ | Soporte | 10+ enfermedades |
121
+ | Idioma | Español |
122
+ | Costo | Gratis |
123
+
124
+ ---
125
+
126
+ ## 🎓 Cómo Usar
127
+
128
+ ### Para Productores
129
+
130
+ 1. **Toma una foto clara** de la hoja afectada
131
+ - Buena iluminación natural
132
+ - Enfoque en los síntomas
133
+ - Hoja completa visible
134
+
135
+ 2. **Sube la imagen** en la interfaz
136
+
137
+ 3. **Obtén el diagnóstico**:
138
+ - Nombre de la enfermedad
139
+ - Nivel de confianza
140
+ - Síntomas característicos
141
+ - Tratamiento recomendado
142
+ - Medidas preventivas
143
+
144
+ 4. **Consulta con un agrónomo** para confirmar y aplicar tratamiento
145
+
146
+ ### Para Desarrolladores
147
+
148
+ ```bash
149
+ # Clonar el repositorio
150
+ git clone https://huggingface.co/spaces/Nadinamo/tomato-disease-detector
151
+ cd tomato-disease-detector
152
+
153
+ # Instalar dependencias
154
+ pip install -r requirements.txt
155
+
156
+ # Ejecutar localmente
157
+ python app.py
158
+ ```
159
+
160
+ ---
161
+
162
+ ## 📚 Base de Conocimiento
163
+
164
+ La información proviene de fuentes confiables:
165
+
166
+ ### Fuentes Principales
167
+
168
+ - **INTA**: Boletines técnicos y guías de manejo integrado
169
+ - **SENASA**: Productos fitosanitarios autorizados en Argentina
170
+ - **Facultades de Agronomía**: UBA, UNR, UNC
171
+ - **Literatura científica**: Papers peer-reviewed sobre fitopatología
172
+
173
+ ### Cobertura Regional
174
+
175
+ Información específica para:
176
+ - 🌾 **NOA**: Salta, Tucumán, Jujuy
177
+ - 🌿 **Cuyo**: Mendoza, San Juan
178
+ - 🌱 **Litoral**: Santa Fe, Entre Ríos, Corrientes
179
+ - 🏙️ **Centro**: Buenos Aires, Córdoba
180
+
181
+ ---
182
+
183
+ ## 🔬 Metodología
184
+
185
+ ### Pipeline de Diagnóstico
186
+
187
+ ```
188
+ ┌─────────────┐
189
+ │ Imagen │
190
+ │ de Hoja │
191
+ └──────┬──────┘
192
+
193
+
194
+ ┌─────────────────────┐
195
+ │ Modelo de Visión │ → Clasificación: "Early Blight"
196
+ │ (MobileNetV2) │ Confianza: 94%
197
+ └──────┬──────────────┘
198
+
199
+
200
+ ┌─────────────────────┐
201
+ │ Sistema RAG │ → Recupera documentos técnicos
202
+ │ (FAISS + Embeddings│ relevantes de base INTA
203
+ └──────┬──────────────┘
204
+
205
+
206
+ ┌─────────────────────┐
207
+ │ Generación NLP │ → Crea reporte personalizado
208
+ │ (FLAN-T5) │ con contexto argentino
209
+ └──────┬──────────────┘
210
+
211
+
212
+ ┌─────────────────────┐
213
+ │ Diagnóstico │
214
+ │ Completo │
215
+ └─────────────────────┘
216
+ ```
217
+
218
+ ### Validación
219
+
220
+ - Modelo entrenado en **PlantVillage dataset** (54,000+ imágenes)
221
+ - Validado con casos reales de Argentina
222
+ - Información contrastada con guías técnicas de INTA
223
+
224
+ ---
225
+
226
+ ## ⚠️ Limitaciones y Disclaimer
227
+
228
+ ### Limitaciones Técnicas
229
+
230
+ - ⚠️ El modelo fue entrenado con dataset internacional (PlantVillage)
231
+ - ⚠️ Puede tener variaciones con condiciones locales específicas
232
+ - ⚠️ Requiere fotos de buena calidad para precisión óptima
233
+ - ⚠️ No reemplaza el diagnóstico de laboratorio
234
+
235
+ ### Disclaimer Legal
236
+
237
+ > **IMPORTANTE**: Este sistema es una herramienta de apoyo para diagnóstico preliminar y educación. **NO reemplaza** la consulta con profesionales agronómicos certificados (Ingenieros Agrónomos, técnicos de INTA, etc.).
238
+ >
239
+ > Para decisiones de manejo de cultivo, aplicación de agroquímicos y estrategias de control, **siempre consulte con un profesional**.
240
+
241
+ ---
242
+
243
+ ## 🌍 Impacto y Casos de Uso
244
+
245
+ ### Usuarios Objetivo
246
+
247
+ - 👨‍🌾 **Productores pequeños y medianos**: Diagnóstico rápido en campo
248
+ - 🎓 **Estudiantes de agronomía**: Herramienta educativa
249
+ - 🔬 **Extensionistas rurales**: Apoyo en consultas técnicas
250
+ - 🏫 **Instituciones educativas**: Material didáctico interactivo
251
+
252
+ ### Casos de Uso Reales
253
+
254
+ 1. **Diagnóstico en campo**: Productor detecta manchas, usa el celular para diagnóstico inmediato
255
+ 2. **Educación**: Estudiantes aprenden a identificar enfermedades con casos reales
256
+ 3. **Monitoreo preventivo**: Análisis regular de plantas para detección temprana
257
+ 4. **Segunda opinión**: Validar sospecha antes de consultar agrónomo
258
+
259
+ ---
260
+
261
+ ## 🚧 Roadmap
262
+
263
+ ### Versión 1.0 (Actual) ✅
264
+ - [x] Clasificación de 10+ enfermedades
265
+ - [x] RAG con documentos INTA
266
+ - [x] Interfaz en español
267
+ - [x] Deployment en Hugging Face
268
+
269
+ ### Versión 2.0 (Próximamente)
270
+ - [ ] Fine-tuning con dataset argentino propio
271
+ - [ ] Detección de severidad (leve, moderada, grave)
272
+ - [ ] Más cultivos: soja, maíz, trigo
273
+ - [ ] Integración con APIs de clima (alertas preventivas)
274
+ - [ ] Modo offline para zonas rurales sin internet
275
+ - [ ] App móvil nativa (Android/iOS)
276
+
277
+ ### Versión 3.0 (Futuro)
278
+ - [ ] Detección de múltiples enfermedades simultáneas
279
+ - [ ] Estimación de pérdidas económicas
280
+ - [ ] Recomendación de productos específicos por zona
281
+ - [ ] Integración con sistemas de gestión de fincas
282
+ - [ ] Soporte multiidioma (inglés, portugués)
283
+
284
+ ---
285
+
286
+ ## 🤝 Contribuciones
287
+
288
+ ¡Las contribuciones son bienvenidas! Especialmente valiosas:
289
+
290
+ ### Áreas de Contribución
291
+
292
+ - 📸 **Imágenes**: Dataset de enfermedades en condiciones argentinas
293
+ - 📄 **Documentación**: Guías técnicas actualizadas de INTA
294
+ - 🐛 **Bugs**: Reportar errores o comportamientos inesperados
295
+ - 💡 **Features**: Sugerir nuevas funcionalidades
296
+ - 🌍 **Traducciones**: Otros idiomas (portugués, guaraní)
297
+ - 🧪 **Testing**: Validación con casos reales
298
+
299
+ ### Cómo Contribuir
300
+
301
+ 1. Fork este Space
302
+ 2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`)
303
+ 3. Commit tus cambios (`git commit -m 'Add: AmazingFeature'`)
304
+ 4. Push a la rama (`git push origin feature/AmazingFeature`)
305
+ 5. Abre un Pull Request
306
+
307
+ O simplemente abre un **Discussion** en este Space con tu idea.
308
+
309
+ ---
310
+
311
+ ## 📖 Recursos Adicionales
312
+
313
+ ### Datasets
314
+
315
+ - **PlantVillage**: [Kaggle Dataset](https://www.kaggle.com/datasets/emmarex/plantdisease)
316
+ - **PlantDoc**: [GitHub Repository](https://github.com/pratikkayal/PlantDoc-Dataset)
317
+ - **DeepWeeds**: Para malezas (futuro)
318
+
319
+ ### Documentación Técnica
320
+
321
+ - [INTA - Publicaciones Técnicas](https://inta.gob.ar/documentos)
322
+ - [SENASA - Fitosanitarios](https://www.argentina.gob.ar/senasa)
323
+ - [FAO - Manejo Integrado de Plagas](http://www.fao.org/agriculture/crops/core-themes/theme/pests/ipm/es/)
324
+
325
+ ### Papers Relevantes
326
+
327
+ - [Plant Disease Detection using Deep Learning (2019)](https://arxiv.org/abs/1904.12175)
328
+ - [Transfer Learning for Plant Disease Recognition (2020)](https://www.nature.com/articles/s41598-020-76442-2)
329
+
330
+ ---
331
+
332
+ ## 👥 Créditos
333
+
334
+ ### Desarrollado por
335
+
336
+ Nadina Mokryj - https://github.com/nadinamo - https://www.linkedin.com/in/nadina-mokryj/
337
+
338
+ ### Agradecimientos
339
+
340
+ - **Hugging Face**: Por la plataforma y modelos pre-entrenados
341
+ - **INTA Argentina**: Por la documentación técnica pública
342
+ - **PlantVillage**: Por el dataset de imágenes
343
+ - **Comunidad open-source**: Bibliotecas y frameworks utilizados
344
+
345
+ ---
346
+
347
+ ## 📄 Licencia
348
+
349
+ Este proyecto está bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para detalles.
350
+
351
+ ```
352
+ MIT License - Copyright (c) 2025
353
+ ```
354
+
355
+ Esto significa que puedes:
356
+ - ✅ Usar comercialmente
357
+ - ✅ Modificar el código
358
+ - ✅ Distribuir
359
+ - ✅ Uso privado
360
+
361
+ Con la condición de mantener el aviso de copyright y licencia.
362
+
363
+ ---
364
+
365
+ ## 📧 Contacto
366
+
367
+ ¿Preguntas? ¿Sugerencias? ¿Colaboraciones?
368
+
369
+ - 💬 **Discussions**: Usa la pestaña "Community" de este Space
370
+ - 📧 **Email**: [email protected]
371
+ - 🐙 **GitHub**: nadinamo
372
+ - 💼 **LinkedIn**: nadina-mokryj
373
+
374
+ ---
375
+
376
+ ## 🌟 Apóyanos
377
+
378
+ Si este proyecto te resultó útil:
379
+
380
+ - ⭐ Dale una estrella en Hugging Face
381
+ - 🔄 Compártelo con productores y estudiantes
382
+ - 💬 Deja tu feedback en Discussions
383
+ - 🤝 Contribuye con mejoras
384
+
385
+ ---
386
+
387
+ <div align="center">
388
+
389
+ **🌱 Ayudando a los productores argentinos con tecnología de vanguardia 🇦🇷**
390
+
391
+ [![Hugging Face](https://img.shields.io/badge/🤗-Hugging%20Face-orange)](https://huggingface.co/)
392
+ [![Made with Python](https://img.shields.io/badge/Made%20with-Python-blue)](https://www.python.org/)
393
+ [![Powered by INTA](https://img.shields.io/badge/Powered%20by-INTA-green)](https://inta.gob.ar/)
394
+
395
+ ---
396
+
397
+ *Última actualización: Octubre 2025*
398
+
399
+ </div>