LauraM655 commited on
Commit
e5bdd52
·
verified ·
1 Parent(s): 8e45d2d

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +56 -39
README.md CHANGED
@@ -17,39 +17,43 @@ license: apache-2.0
17
  ## ✨ Características Principales
18
 
19
  ### 🔍 Búsqueda Semántica Inteligente
20
- - **Matching inteligente**: Usa embeddings multilingües para entender sinónimos y español nativo.
21
- - **Recomendaciones contextuales**: Encuentra recetas incluso con ingredientes parcialmente coincidentes.
22
- - **Filtros avanzados**: Personaliza por tiempo, dieta y categorías.
 
23
 
24
  ### 🏃‍♂️ Optimización de Rendimiento
25
- - **Carga rápida**: Embeds pre-calculados para respuestas instantáneas.
26
- - **Cache inteligente**: Procesamiento optimizado.
27
- - **Interfaz responsiva**: Diseño moderno y fluido.
28
 
29
  ### 📊 Visualización de Datos
30
- - **Gráficos interactivos**: Visualiza tiempos con Plotly.
31
- - **Tarjetas informativas**: Presentación clara con tablas y expanders.
32
-
33
- ### 🤖 Chatbot de Consejos
34
- - **Asesoría interactiva**: Pregunta por modificaciones o procedimientos; usa modelo en español con contexto RAG-like.
35
 
36
  ## 🚀 Cómo Usar
37
 
38
- 1. **Ingresa ingredientes** en español (ej: "tomate, cebolla, pollo").
39
- 2. **Ajusta los filtros** en la barra lateral.
40
- 3. **Haz clic en "Buscar Recetas"**.
41
- 4. **Explora los resultados**: Tablas de ingredientes, pasos expandibles.
42
- 5. **Usa el chatbot**: Para consejos como "cómo hacer vegano".
 
 
 
 
 
 
43
 
44
  ## 🛠️ Tecnologías Utilizadas
45
 
46
- - **Streamlit**: Interfaz web interactiva.
47
- - **Hugging Face Transformers**: Modelos de embeddings y generación (e.g., gpt-2-spanish).
48
- - **Sentence Transformers**: Embeddings multilingües para matching.
49
- - **Plotly**: Visualizaciones interactivas.
50
- - **Pandas/NumPy**: Procesamiento de datos eficiente.
51
- - **scikit-learn**: Cálculo de similitudes coseno.
52
- - **Dataset**: "somosnlp/RecetasDeLaAbuela" para recetas en español.
53
 
54
  ## 📁 Estructura del Proyecto
55
 
@@ -57,49 +61,62 @@ license: apache-2.0
57
  recetas-saludables-ia/
58
  ├── app.py # Aplicación Streamlit principal
59
  ├── requirements.txt # Dependencias del proyecto
60
- ├── README.md # Documentación
61
- └── .gitattributes # Configuración Git LFS
62
  ```
63
 
64
  ## 🔧 Instalación Local
65
 
66
- ```
67
  # Clonar el repositorio
68
  git clone https://huggingface.co/spaces/LauraM655/recetas-saludables-ia
 
69
  # Instalar dependencias
70
  pip install -r requirements.txt
 
71
  # Ejecutar la aplicación
72
  streamlit run app.py
73
  ```
74
 
75
  ## 📈 Rendimiento Optimizado
76
 
77
- - **Pre-cálculo de embeddings**: Calculados una vez al inicio.
78
- - **Cache multi-nivel**: Para búsquedas y generación.
79
- - **Procesamiento por lotes**: Operaciones vectorizadas.
80
- - **Manejo de errores robusto**: Validación completa.
81
 
82
  ## 🎯 Casos de Uso
83
 
84
- - **Estudiantes**: Recetas rápidas.
85
- - **Familias**: Comidas saludables.
86
- - **Deportistas**: Opciones nutritivas.
87
- - **Dietas específicas**: Vegano, bajo en calorías.
88
- - **Cocina creativa**: Descubre combinaciones con chatbot.
89
 
90
  ## 🤝 Contribuir
91
 
92
- ¡Las contribuciones son bienvenidas! Reporta issues o fork el proyecto.
 
 
 
 
93
 
94
  ## 📄 Licencia
95
 
96
- Apache 2.0.
97
 
98
  ## 🌐 Demo en Vivo
99
 
100
- [https://huggingface.co/spaces/LauraM655/recetas-saludables-ia](https://huggingface.co/spaces/LauraM655/recetas-saludables-ia)
101
 
102
  ---
103
 
 
 
104
  *Hecho con ❤️ usando Hugging Face Spaces*
105
- ```
 
 
 
 
 
 
17
  ## ✨ Características Principales
18
 
19
  ### 🔍 Búsqueda Semántica Inteligente
20
+ - **Matching inteligente**: Usa embeddings de Sentence Transformers para entender el significado de tus ingredientes
21
+ - **Recomendaciones contextuales**: Encuentra recetas incluso con ingredientes parcialmente coincidentes
22
+ - **Filtros avanzados**: Personaliza por calorías, tiempo, dieta y categorías
23
+ - **Soporte multilingüe**: Ingresa ingredientes en español o inglés, con manejo de sinónimos # MEJORA: Agregado
24
 
25
  ### 🏃‍♂️ Optimización de Rendimiento
26
+ - **Carga rápida**: Embeds pre-calculados para respuestas instantáneas
27
+ - **Cache inteligente**: Traducciones y procesamiento optimizado
28
+ - **Interfaz responsiva**: Diseño moderno y fluido con listas mejoradas # MEJORA: Mencionado
29
 
30
  ### 📊 Visualización de Datos
31
+ - **Gráficos interactivos**: Visualiza calorías vs tiempo con Plotly
32
+ - **Tarjetas informativas**: Presentación clara de cada receta con listas ordenadas
33
+ - **Metadatos completos**: Información nutricional, tiempos e ingredientes
 
 
34
 
35
  ## 🚀 Cómo Usar
36
 
37
+ 1. **Ingresa ingredientes** en el campo principal (ej: "pollo, arroz, vegetales" en español o inglés)
38
+ 2. **Ajusta los filtros** en la barra lateral:
39
+ - Calorías máximas
40
+ - Tiempo de preparación
41
+ - Preferencias dietéticas (vegano, saludable)
42
+ 3. **Haz clic en "Buscar Recetas"**
43
+ 4. **Explora los resultados**:
44
+ - Gráfico de distribución
45
+ - Tarjetas detalladas de cada receta
46
+ - Información nutricional completa
47
+ - Instrucciones paso a paso
48
 
49
  ## 🛠️ Tecnologías Utilizadas
50
 
51
+ - **Streamlit**: Interfaz web interactiva
52
+ - **Hugging Face Transformers**: Modelos de traducción y embeddings
53
+ - **Sentence Transformers**: Embeddings semánticos multilingües para matching de ingredientes # MEJORA: Multilingües
54
+ - **Plotly**: Visualizaciones interactivas
55
+ - **Pandas/NumPy**: Procesamiento de datos eficiente
56
+ - **scikit-learn**: Cálculo de similitudes coseno
 
57
 
58
  ## 📁 Estructura del Proyecto
59
 
 
61
  recetas-saludables-ia/
62
  ├── app.py # Aplicación Streamlit principal
63
  ├── requirements.txt # Dependencias del proyecto
64
+ ├── README.md # Documentación
65
+ └── .gitattributes # Configuración Git LFS
66
  ```
67
 
68
  ## 🔧 Instalación Local
69
 
70
+ ```bash
71
  # Clonar el repositorio
72
  git clone https://huggingface.co/spaces/LauraM655/recetas-saludables-ia
73
+
74
  # Instalar dependencias
75
  pip install -r requirements.txt
76
+
77
  # Ejecutar la aplicación
78
  streamlit run app.py
79
  ```
80
 
81
  ## 📈 Rendimiento Optimizado
82
 
83
+ - **Pre-cálculo de embeddings**: Los embeddings de las recetas se calculan una vez al inicio con modelo multilingüe
84
+ - **Cache multi-nivel**: Traducciones y resultados frecuentes en cache
85
+ - **Procesamiento por lotes**: Operaciones vectorizadas para máxima velocidad
86
+ - **Manejo de errores robusto**: Validación completa de datos
87
 
88
  ## 🎯 Casos de Uso
89
 
90
+ - **Estudiantes**: Recetas rápidas y económicas
91
+ - **Familias**: Comidas saludables para todos
92
+ - **Deportistas**: Opciones altas en proteínas
93
+ - **Dietas específicas**: Vegano, bajo en calorías, etc.
94
+ - **Cocina creativa**: Descubre nuevas combinaciones en múltiples idiomas
95
 
96
  ## 🤝 Contribuir
97
 
98
+ ¡Las contribuciones son bienvenidas! Si encuentras algún problema o tienes sugerencias:
99
+
100
+ 1. Reporta un issue en la pestaña de "Issues"
101
+ 2. Propone mejoras específicas
102
+ 3. Considera forkear el proyecto
103
 
104
  ## 📄 Licencia
105
 
106
+ Este proyecto está bajo la licencia Apache 2.0. Ver el archivo LICENSE para más detalles.
107
 
108
  ## 🌐 Demo en Vivo
109
 
110
+ Prueba la aplicación: [https://huggingface.co/spaces/LauraM655/recetas-saludables-ia](https://huggingface.co/spaces/LauraM655/recetas-saludables-ia)
111
 
112
  ---
113
 
114
+ <div align="center">
115
+
116
  *Hecho con ❤️ usando Hugging Face Spaces*
117
+
118
+ [![Streamlit](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-the-badge&logo=Streamlit&logoColor=white)](https://streamlit.io)
119
+ [![Hugging Face](https://img.shields.io/badge/Hugging%20Face-FFD21E?style=for-the-badge&logo=huggingface&logoColor=black)](https://huggingface.co)
120
+ [![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
121
+
122
+ </div>