muktarbdulkader/Electric-Demand-Forecasting-System

🇪🇹 ML-powered electricity demand forecasting platform for Ethiopian Electric Utility with React frontend, FastAPI backend, and AI chatbot # ⚡ Ethiopian Electric Utility - AI-Powered Demand Forecasting System **Accurate electricity demand prediction with machine learning, real-time insights, and comprehensive analytics for Ethiopia's national grid.** ## 📋 Table of Contents - Features - Screenshots - Quick Start - Installation - Project Structure - API Documentation - Data Upload Guide - ML Model Details - Configuration - Testing - Deployment - Contributing - License --- ## ✨ Features ### 🔮 **Smart Forecasting** - **ML-Powered Predictions**: Linear Regression with Ethiopian-specific seasonal patterns - **7-Day Forecast**: Weekly demand predictions with confidence intervals - **Real-time Updates**: Continuous model retraining with new data - **Custom Predictions**: Generate forecasts based on temperature, time, and regional factors ### 🤖 **AI Intelligence** - **Real-time Alerts**: Automatic anomaly detection and grid stress warnings - **Smart Recommendations**: Energy-saving and load-balancing suggestions - **Grid Analytics**: Regional performance and infrastructure insights - **Efficiency Scoring**: Household and regional consumption efficiency ratings ### 👥 **User Management** - **Secure Authentication**: JWT-based user registration and login - **Session Management**: Persistent user sessions with refresh tokens - **Profile Dashboard**: Personalized user interface and preferences ### 🏠 **Household Analytics** - **Consumption Tracking**: Register and monitor household electricity usage - **Population Integration**: Demand scaling based on regional population data - **Cost Estimation**: Monthly consumption cost projections ### 📊 **Comprehensive Analytics** - **Interactive Visualizations**: Chart.js powered real-time charts - **Regional Breakdown**: All 11 Ethiopian regions with individual analytics - **Historical Analysis**: Peak demand, energy consumption, and trend analysis - **Data Statistics**: Dataset insights and model performance metrics --- ## 🖼️ Screenshots | Dashboard | AI In …