README.md

---
title: SuperKart Sales Forecasting UI
emoji: 🛒
colorFrom: blue
colorTo: green
sdk: streamlit
sdk_version: 1.28.1
app_file: app.py
pinned: false
license: mit
---

# 🛒 SuperKart Sales Forecasting System

An intelligent sales forecasting system powered by machine learning that helps SuperKart optimize inventory management and make data-driven business decisions.

## 🚀 Features

- **📊 Interactive Predictions**: Single and batch sales forecasting
- **📈 Real-time Analytics**: Live dashboard with business insights
- **🔄 API Integration**: Seamless connection to ML backend
- **📱 User-friendly Interface**: Intuitive design for business users
- **📋 Batch Processing**: Upload CSV files for bulk predictions

## 🎯 Quick Start

1. **Configure API URL**: Set your backend API endpoint in the app
2. **Single Prediction**: Enter product and store details for instant forecasting
3. **Batch Processing**: Upload CSV file for multiple predictions
4. **View Analytics**: Explore interactive charts and insights

## 🔧 Configuration

### Backend API Connection
- Navigate to "API Status" in the sidebar
- Enter your backend API URL (e.g., `https://your-backend-api.hf.space`)
- Test the connection to ensure it's working

### Input Format
Required fields for predictions:
- Product Weight, Sugar Content, Allocated Area, Type, MRP
- Store Size, Location City Type, Store Type, Age

## 📊 Business Intelligence

The system provides actionable insights including:
- Sales performance analysis by product categories
- Store performance comparisons
- Regional sales patterns
- Inventory optimization recommendations

## 🛠️ Technical Details

- **Framework**: Streamlit
- **ML Backend**: Flask API with scikit-learn
- **Deployment**: Hugging Face Spaces
- **Container**: Docker-based deployment

## 📞 Support

For technical support or business consultation, contact the SuperKart ML Analytics Team.

---

**Transform your retail operations with AI-powered sales forecasting!** 🌟