GrowthOS V2 is a domain-specific, AI-assisted decision-intelligence platform built for Indian retail businesses. It transforms raw retail data into actionable business decisions using a strict diagnostic loop: Data → Diagnosis → Prediction → Simulation → Recommendation → Action → Measurement.
- Executive Command Center Dashboard: Real-time Health Score (0-100), 30-day revenue trends, transaction metrics, and category revenue share distribution.
- Automated Root-Cause Variance Engine: Multi-dimensional variance breakdown (Volume vs. Price/Mix effect, Store drivers, Category drivers).
- RFM Customer Intelligence & Churn Alert: Recency, Frequency, and Monetary segmentation (VIPs, Loyal, At-Risk Churn warnings).
- Inventory Days of Cover (DoC) & Stockout Risk: Velocity forecasting, Days of Cover calculations, and automated purchase order reorder points.
- Interactive Scenario Decision Simulator: Dual-slider what-if simulator projecting 30-day revenue and gross margin impact for promotional discounts & price updates.
- "Ask GrowthOS" Grounded AI Assistant: OpenRouter free models API integration + deterministic grounded rule fallback engine with evidence citations.
- Adaptive Multi-Tenant Demo Dataset: 3 pre-seeded retail profiles (High-Tech Multi-Store, Medium Digital Kirana, Basic Traditional Store) demonstrating graceful degradation.
- Frontend: React + TypeScript + Vite (Clean, crisp, light-themed professional enterprise UI; no harsh gradients).
- Backend: Python FastAPI + Pydantic v2 + SQLAlchemy ORM (Calculations in Pandas/NumPy).
- Database: Supabase PostgreSQL (Free Tier compatible) + SQLite fallback (
growthos.db). - AI Engine: OpenRouter API (
meta-llama/llama-3.3-70b-instruct:free) with strict evidence grounding.
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 -c "from app.seed.seed_data import seed_database; seed_database()"
uvicorn app.main:app --host 0.0.0.0 --port 8000- API Documentation:
http://localhost:8000/docs
cd frontend
npm install
npm run dev- Command Center App:
http://localhost:5173orhttp://localhost:5174
- Frontend: Deploy on Vercel or Netlify (Free Static Hosting).
- Backend: Deploy on Render (Free Web Service).
- Database: Deploy on Supabase (Free Cloud PostgreSQL).
- AI Models: Powered by OpenRouter Free Tier Models.