Spaces:
Sleeping
Sleeping
Commit
·
a824c22
1
Parent(s):
f810b2f
updated readme
Browse files
README.md
CHANGED
@@ -1,99 +1,10 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
|
12 |
-
- **Inteligencia Artificial de Lenguaje**:
|
13 |
-
- 💬 [LangChain](https://www.langchain.com/) para orquestación de LLMs
|
14 |
-
- 🔄 [LangGraph](https://github.com/langchain-ai/langgraph) para flujos de trabajo de agentes
|
15 |
-
- 🧠 [Gemini 2.5](https://deepmind.google/technologies/gemini/) (vía OpenRouter) para procesamiento de lenguaje natural
|
16 |
-
|
17 |
-
- **Gestión de Datos**:
|
18 |
-
- 🔍 Embeddings vectoriales con HuggingFace (BAAI/bge-m3)
|
19 |
-
- 💾 Datos de menú almacenados en formato Markdown
|
20 |
-
- 🗄️ [Supabase](https://supabase.com/) para almacenamiento y procesamiento de pedidos
|
21 |
-
|
22 |
-
- **Interfaz**:
|
23 |
-
- 🧪 [Gradio](https://www.gradio.app/) para la interfaz web interactiva
|
24 |
-
|
25 |
-
## 🚀 Características
|
26 |
-
|
27 |
-
- **Interacción por voz en tiempo real** con un asistente virtual de camarero
|
28 |
-
- **Consulta de información del menú** con respuestas contextuales sobre platos, precios y opciones
|
29 |
-
- **Procesamiento de pedidos** con capacidad para enviar órdenes directamente a sistemas de cocina
|
30 |
-
- **Flujo conversacional natural** usando LangGraph para orquestación compleja de agentes
|
31 |
-
- **Integración de base de conocimientos** con RAG (Retrieval Augmented Generation)
|
32 |
-
- **Memoria de conversación multi-turno** para respuestas contextuales
|
33 |
-
- **Gestión de pedidos** con almacenamiento en Supabase y sistema de seguimiento
|
34 |
-
- **Síntesis de voz expresiva** con ElevenLabs para respuestas naturales y fluidas
|
35 |
-
|
36 |
-
## 🚀 Primeros Pasos
|
37 |
-
|
38 |
-
1. Clona este repositorio
|
39 |
-
2. Instala las dependencias: `pip install -r requirements.txt` (requiere Python 3.10+)
|
40 |
-
3. Crea un archivo `.env` con tus claves API:
|
41 |
-
```
|
42 |
-
OPENROUTER_API_KEY=tu_clave_openrouter
|
43 |
-
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
|
44 |
-
GROQ_API_KEY=tu_clave_groq
|
45 |
-
ELEVENLABS_API_KEY=tu_clave_elevenlabs
|
46 |
-
HELICONE_API_KEY=tu_clave_helicone_opcional
|
47 |
-
SUPABASE_URL=tu_url_supabase
|
48 |
-
SUPABASE_KEY=tu_clave_supabase
|
49 |
-
```
|
50 |
-
4. Ejecuta la aplicación: `python app.py`
|
51 |
-
5. Abre la interfaz de Gradio en tu navegador
|
52 |
-
|
53 |
-
## 🗂️ Estructura del Proyecto
|
54 |
-
|
55 |
-
- `app.py` - Punto de entrada principal con interfaz Gradio
|
56 |
-
- `agent.py` - Implementación del agente LangGraph para asistente de restaurante
|
57 |
-
- `model.py` - Gestor para la creación y configuración de modelos de lenguaje
|
58 |
-
- `tools.py` - Herramientas personalizadas para consulta de menú y envío de pedidos
|
59 |
-
- `supabase_client.py` - Cliente para operaciones con la base de datos Supabase
|
60 |
-
- `data/carta.md` - Datos del menú del restaurante en formato Markdown
|
61 |
-
- `utils/` - Módulos de utilidad:
|
62 |
-
- `functions.py` - Funciones auxiliares para manejo de mensajes y modelos
|
63 |
-
- `logger.py` - Sistema de registro con colores para depuración
|
64 |
-
- `classes.py` - Clases de datos como `Order` para representar pedidos
|
65 |
-
|
66 |
-
## 🧠 Cómo Funciona
|
67 |
-
|
68 |
-
1. **Reconocimiento de Voz**: FastRTC captura audio del micrófono del usuario y lo envía a la API Whisper de Groq para transcripción
|
69 |
-
2. **Procesamiento de Lenguaje Natural**: El texto transcrito se pasa al agente LangGraph
|
70 |
-
3. **Procesamiento RAG**: El agente utiliza búsqueda vectorial para encontrar información relevante del menú
|
71 |
-
4. **Herramientas del Agente**: El sistema utiliza herramientas especializadas para:
|
72 |
-
- Búsqueda de información en el menú (vectores)
|
73 |
-
- Envío de pedidos a cocina (integración Supabase)
|
74 |
-
5. **Generación de Respuesta**: Gemini 2.5 (a través de OpenRouter) genera una respuesta contextual y útil
|
75 |
-
6. **Síntesis de Voz**: ElevenLabs convierte la respuesta de texto a voz natural
|
76 |
-
7. **Interfaz Web**: Gradio renderiza la conversación y reproduce la respuesta de audio
|
77 |
-
|
78 |
-
## 📦 Requisitos del Sistema
|
79 |
-
|
80 |
-
Los requisitos detallados se encuentran en el archivo `requirements.txt`. Las principales dependencias incluyen:
|
81 |
-
|
82 |
-
- Python 3.10+
|
83 |
-
- gradio >= 4.26.0
|
84 |
-
- langchain >= 0.1.0 (con varios componentes adicionales)
|
85 |
-
- fastrtc >= 0.6.0
|
86 |
-
- elevenlabs >= 0.2.24
|
87 |
-
- groq >= 0.4.0
|
88 |
-
- supabase >= 2.0.0
|
89 |
-
- sentence-transformers >= 2.2.2
|
90 |
-
|
91 |
-
## 📝 Licencia
|
92 |
-
|
93 |
-
[MIT License](LICENSE)
|
94 |
-
|
95 |
-
---
|
96 |
-
|
97 |
-
🌐 Desarrollado por Roberto - 2024
|
98 |
-
|
99 |
-
|
|
|
1 |
+
title: WAIter
|
2 |
+
emoji: 👨🏼🍳
|
3 |
+
colorFrom: indigo
|
4 |
+
colorTo: indigo
|
5 |
+
sdk: gradio
|
6 |
+
sdk_version: 5.25.2
|
7 |
+
app_file: app.py
|
8 |
+
pinned: false
|
9 |
+
hf_oauth: true
|
10 |
+
hf_oauth_expiration_minutes: 480
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|