🚀 Visión General

Los minoristas modernos pierden ingresos significativos debido a desabastecimientos, exceso de stock, pronósticos de demanda inexactos y lentitud en la toma de decisiones de inventario. Los sistemas tradicionales de gestión de inventario a menudo se basan en reglas estáticas y análisis manuales, lo que dificulta responder rápidamente a las condiciones cambiantes del negocio.

StockPilot AI es una Plataforma de Inteligencia de Inventario Multi-Agente Empresarial que transforma datos brutos de inventario en información de negocio procesable utilizando un enjambre colaborativo de agentes de IA. Construido con Google Agent Development Kit (ADK), Gemini 2.5 Flash y el Model Context Protocol (MCP), la plataforma permite que agentes de IA especializados trabajen juntos para analizar el inventario, detectar riesgos operativos, pronosticar la demanda, optimizar las decisiones de compra y generar informes de negocio listos para ejecutivos.

Al combinar orquestación de IA modular con habilidades de inteligencia empresarial reutilizables, StockPilot AI demuestra cómo las organizaciones empresariales pueden aprovechar los sistemas de IA colaborativa para construir aplicaciones de soporte de decisiones escalables, explicables y listas para producción.

📚 Tabla de Contenidos

• 🚀 Visión General

• ✨ Características Clave

• 🏗️ Arquitectura del Sistema

• 🤖 Responsabilidades de los Agentes de IA

• 🔄 Flujo de Trabajo Multi-Agente

• 🛠️ Stack Tecnológico

• 📈 Impacto en el Negocio

• 🚀 Inicio Rápido

• 📂 Estructura del Repositorio

• 🗺️ Hoja de Ruta Futura

• 🤝 Contribuciones

• 📄 Licencia

✨ Características Clave

• 🤖 Inteligencia de Enjambre Multi-Agente impulsada por Google ADK

• 🧠 Coordinador Principal con Agentes de IA Especializados

• 🔌 Integración del Model Context Protocol (MCP)

• 📊 Análisis de Salud del Inventario impulsado por IA

• 📈 Pronóstico de Demanda y Análisis de Velocidad de Ventas

• ⚠️ Detección de Riesgos de Desabastecimiento y Exceso de Stock

• 💰 Optimización del Capital de Trabajo

• 📦 Recomendaciones de Compras Inteligentes

• 📄 Generación de Informes Ejecutivos de Negocio

• 🔒 Seguridad de Grado Empresarial y Validación de Entradas

• 🎨 Panel Interactivo Moderno construido con Streamlit

🌟 Aspectos Destacados del Proyecto

✔ Arquitectura de IA Multi-Agente Empresarial

✔ Construido con Google Agent Development Kit (ADK)

✔ Impulsado por Gemini 2.5 Flash

✔ Comunicación de Herramientas basada en MCP

✔ Integración de FastMCP

✔ Inteligencia de Salud del Inventario

✔ Recomendaciones de Compras con IA

✔ Informes Ejecutivos de Negocio

✔ Panel Interactivo de Streamlit

✔ Diseño Modular y Escalable

🏗️ Arquitectura del Sistema

StockPilot AI sigue una arquitectura multi-agente modular de grado empresarial donde el razonamiento de IA, la lógica de negocio y la ejecución de herramientas están claramente separados. La plataforma aprovecha Google Agent Development Kit (ADK) para orquestar agentes de IA especializados, mientras que FastMCP expone habilidades de inteligencia empresarial reutilizables a través del Model Context Protocol (MCP).

El Agente Coordinador Principal delega tareas a agentes de IA específicos del dominio responsables del análisis de inventario, pronóstico de demanda, detección de riesgos de inventario, generación de recomendaciones de compra y elaboración de informes ejecutivos. Cada agente realiza una responsabilidad especializada antes de producir colaborativamente una decisión empresarial unificada.

Esta arquitectura modular mejora la escalabilidad, mantenibilidad, explicabilidad y permite integrar nuevas capacidades de IA con cambios mínimos en el sistema existente.

🤖 Responsabilidades de los Agentes de IA

🔄 Flujo de Trabajo Multi-Agente

El flujo de trabajo comienza con un conjunto de datos de inventario cargado. El Coordinador Principal distribuye las tareas de análisis entre los agentes de IA especializados, cada uno llamando a habilidades de inteligencia de inventario reutilizables a través del Model Context Protocol (MCP). Una vez que todos los análisis están completos, el Coordinador agrega los resultados en un informe ejecutivo que contiene información de inventario, pronósticos de demanda, recomendaciones de compra e inteligencia empresarial.

🛠️ Stack Tecnológico

📈 Impacto en el Negocio

StockPilot AI está diseñado para apoyar la toma de decisiones de inventario basada en datos, combinando razonamiento de IA con inteligencia empresarial. En lugar de simplemente analizar registros de inventario, la plataforma ayuda a las organizaciones a identificar riesgos operativos, optimizar estrategias de compra y mejorar el rendimiento del inventario a través de agentes de IA colaborativos.

Beneficios Clave para el Negocio

• 📉 Reducir desabastecimientos de inventario mediante análisis proactivo de la demanda

• 📦 Minimizar el exceso de inventario y los costos de mantenimiento

• 💰 Mejorar la utilización del capital de trabajo

• 📈 Pronosticar la demanda futura de inventario utilizando información de IA

• ⚠️ Detectar riesgos de inventario antes de que afecten las operaciones

• 🤖 Automatizar recomendaciones de compra

• 📊 Generar informes ejecutivos de negocio

• 🚀 Acelerar la toma de decisiones estratégicas de inventario

🌟 ¿Por qué StockPilot AI?

A diferencia de los sistemas tradicionales de gestión de inventario que se basan en reglas de negocio estáticas, StockPilot AI combina múltiples agentes de IA especializados que colaboran para resolver desafíos complejos de inventario.

Sistemas de Inventario Tradicionales

• Análisis manual de inventario

• Reglas de negocio estáticas

• Capacidad de pronóstico limitada

• Toma de decisiones reactiva

• Informes fragmentados

StockPilot AI

• Colaboración de IA Multi-Agente

• Pronóstico Inteligente de Demanda

• Detección de Riesgos basada en IA

• Recomendaciones Automatizadas de Compras

• Inteligencia Empresarial Ejecutiva

• Arquitectura Modular y Escalable

• Soporte de Decisiones de IA Explicable

✨ Características Empresariales

🚀 Inicio Rápido

Sigue los pasos a continuación para ejecutar StockPilot AI localmente.

Related MCP server: confirmation-outlook-mcp

📦 Clonar el Repositorio

git clone https://github.com/ankitachotaliya2310/StockPilot-AI.git
cd StockPilot-AI

📥 Instalar Dependencias

Instala todos los paquetes de Python requeridos.

pip install -r requirements.txt

🔑 Configurar el Entorno

Crea un archivo .env usando .env.example.

GEMINI_API_KEY=YOUR_GEMINI_API_KEY
GEMINI_MODEL=gemini-2.5-flash

✅ Verificar la Instalación

Ejecuta el conjunto de verificación para validar las herramientas MCP, los agentes de IA y las habilidades reutilizables.

python -X utf8 verify_system.py

▶️ Iniciar StockPilot AI

Inicia la aplicación Streamlit.

streamlit run app.py

Abre tu navegador y navega a:

http://localhost:8501

📂 Estructura del Repositorio

StockPilot-AI
│
├── Assets/
│   ├── Cover.png
│   ├── Logo.png
│   ├── Architecture.png
│   ├── Architecture Overview.png
│   ├── Workflow.png
│   └── business-impact.png
│
├── Datasets/
│   ├── sample_inventory.csv
│   ├── test_dataset_balanced.csv
│   ├── test_dataset_overstocks.csv
│   └── test_dataset_shortages.csv
│
├── doc/
│   └── architecture.md
│
├── agents.py
├── app.py
├── data_generator.py
├── mcp_server.py
├── skills.py
├── tools.py
├── style.css
├── verify_system.py
├── requirements.txt
├── walkthrough.md
├── README.md
├── LICENSE
└── .gitignore

🔗 Explora StockPilot AI

🗺️ Hoja de Ruta Futura

StockPilot AI está diseñado como una plataforma escalable de inteligencia de inventario empresarial. Las mejoras futuras pueden incluir:

• 🌐 Gestión de Inventario Multi-Almacén

• 📡 Integración en Tiempo Real con ERP y SAP

• 🤖 Motor de Recomendación de Proveedores con IA

• 📈 Pronóstico Predictivo Avanzado de Demanda

• 📦 Generación Automatizada de Órdenes de Compra

• 🔐 Autenticación de Usuarios basada en Roles

• ☁️ Despliegue Nativo en la Nube

• 📊 Panel de Inteligencia Empresarial en Tiempo Real

• 🔔 Alertas y Notificaciones Inteligentes de Inventario

• 🌍 Soporte Empresarial Multi-Idioma

🤝 Contribuciones

¡Las contribuciones son bienvenidas!

Si deseas mejorar StockPilot AI, no dudes en:

• Hacer un fork del repositorio

• Crear una rama de funcionalidad

• Enviar un Pull Request

• Reportar errores o sugerir mejoras a través de Issues de GitHub

🙏 Agradecimientos

Este proyecto fue construido utilizando tecnologías modernas de IA e ingeniería de datos, incluyendo:

• Google Agent Development Kit (ADK)

• Gemini 2.5 Flash

• Model Context Protocol (MCP)

• FastMCP

• Streamlit

• Pandas

• Plotly

• Python

Agradecimientos especiales al programa Google × Kaggle AI Agents Capstone por inspirar el desarrollo de este proyecto.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT.

Consulte el archivo LICENSE para obtener más detalles.

⭐ Si encontró útil este proyecto, considere darle una estrella en GitHub.

Construido con ❤️ usando Google Agent Development Kit (ADK), Gemini y Streamlit