Voice-to-SQL Dashboard

FastAPI Python Groq Ollama Llama ReAct React Vue Tailwind Vanilla JS Web Audio Chart.js
Voice-to-SQL Dashboard

Voice-to-SQL Dashboard: Consultas Analíticas con Automatización Extrema

Este proyecto es un panel analítico inteligente que elimina por completo la fricción del usuario a la hora de consultar e interpretar datos complejos. El sistema permite interactuar mediante lenguaje natural (texto o voz), procesa la petición a través de agentes autónomos, autogenera consultas SQL seguras en caliente, ejecuta los queries y devuelve tanto la representación gráfica como un análisis de negocio automatizado.

La innovación clave reside en su enfoque de "cero clics": el usuario no solo obtiene un gráfico, sino que el sistema deduce la intención comercial, audita la seguridad del código y extrae conclusiones automatizadas sin intervención humana.

🛠️ Arquitectura del Sistema

El proyecto está diseñado bajo una arquitectura desacoplada, optimizada para un consumo eficiente de recursos y baja latencia:

  • Frontend (Interfaz de Usuario):
  • Dashboard SPA (Single Page Application) responsivo construido en Vanilla JS / Tailwind CSS.
  • Integración con la API nativa Web Audio para la captura de flujos de voz sin dependencias pesadas.
  • Renderizado dinámico de gráficos mediante Chart.js o ApexCharts basado en esquemas JSON variables.
  • Backend (Motor de Orquestación):
  • FastAPI (Python) gestionando peticiones de forma totalmente asíncrona.
  • Cola de mensajes interna con Redis para el manejo de flujos de ejecución y control de rate limits de las APIs de IA.
  • Cerebro e Inferencia (Modelos LLM):
  • Capa Externa (Alta Complejidad): Conexión vía API a Groq empleando modelos avanzados para el mapeo semántico y la interpretación de intenciones ambiguas de negocio.
  • Capa Local (Privacidad y Eficiencia): Instancia local de Ollama ejecutando modelos optimizados para tareas mecánicas como la transcripción local y el formateo estructural de datos.
  • Persistencia (Datos del Negocio):
  • Base de datos relacional sobre SQLite que emula un entorno transaccional real (por ejemplo, métricas de un SaaS, datos de eventos o registros comerciales).

🔄 Flujo de Ejecución y Lógica de Agentes (Patrón ReAct)

El sistema no utiliza frameworks comerciales rígidos; implementa un bucle ReAct (Reason + Act + Observe) nativo programado en Python para garantizar un control milimétrico sobre la base de datos:

Try Live Demo View Code
🤖 Asistente Virtual▲