kpi-lens

[](https://github.com/aliivaezii/kpi-lens/actions/workflows/ci.yml) []() [](LICENSE) [](https://github.com/aliivaezii/kpi-lens/releases) [](https://render.com/deploy?repo=https://github.com/aliivaezii/kpi-lens)

> An AI-powered supply chain intelligence platform that monitors 8 operational KPIs, > detects anomalies using an ensemble of statistical detectors, and explains root causes > via Claude — all accessible through a Streamlit dashboard, FastAPI, and an MCP server.

Supply chain teams spend hours manually reviewing KPI dashboards and writing exception reports. KPI-Lens automates the entire loop: ingest → detect → explain → report. A single docker compose up gives you a live anomaly feed, LLM-generated root-cause narratives, and one-click Excel/PPT exports ready for SteerCo.

• 8 supply chain KPIs tracked weekly: OTIF, Fill Rate, DFA, Inventory Turnover, DIO, Supplier DPPM, Lead Time Variance, PO Cycle Time
• Ensemble anomaly detection: Z-score + IQR + CUSUM + Isolation Forest detectors with weighted voting
• LLM root-cause analysis: Claude generates narrative explanations and recommended actions for each anomaly
• FastAPI backend with 10+ endpoints for KPI data, anomaly management, and LLM chat
• Streamlit dashboard with 5 pages: Command Center, KPI Deep Dive, Anomaly Log, LLM Analyst, Reports
• MCP server for Claude Desktop integration — query live KPI data conversationally
• Automated ingestion: CSV/Excel file watcher with Pydantic v2 validation and APScheduler cron
• Report generation: Excel workbooks and PowerPoint decks for SteerCo presentations
• **80%+