True-African/grid-outage-prioritizer

KTT Power Plan forecasts grid outages and generates appliance-by-appliance ON/OFF plans for small businesses. Features a local dashboard, SMS/voice notifications, and clear docs. Fast, transparent, and easy to adapt for real-world or hackathon use. --- title: Grid Outage Planner sdk: static app_file: lite_ui.html colorFrom: green colorTo: blue short_description: 24-hour outage risk and appliance planning for SMEs. --- # Grid Outage Planner Grid Outage Planner forecasts 24-hour grid-outage risk and converts it into a practical appliance ON/OFF plan for small businesses such as salons, cold rooms, and tailor shops. The dashboard is designed for non-ML users: it shows the highest-risk hour, why risk is rising, which appliances to keep ON or switch OFF, SMS/voice instructions, and expected revenue protected. ## Quick Start Clone from GitHub: ```bash git clone github.com cd Your_grid_outage_prioritizer ``` Alternative clone from Hugging Face Spaces: ```bash git clone huggingface.co cd Your_grid_outage_prioritizer ``` Windows users can double-click: ```text START_DASHBOARD.bat ``` Terminal users can create the virtual environment with: ```bash python -m venv venv ``` Then activate it in the shell you are using: ```powershell # Windows PowerShell .\venv\Scripts\Activate.ps1 ``` ```cmd :: Windows Command Prompt venv\Scripts\activate.bat ``` ```bash # Git Bash on Windows source venv/Scripts/activate ``` After activation, install dependencies and start the local dashboard: ```bash pip install -r requirements.txt python dashboard.py ``` On macOS/Linux, activate the environment with: ```bash source venv/bin/activate ``` Then open: ```text 127.0.0.1 ``` ## What To Try - Switch between `salon`, `cold room`, and `tailor`. - Click `Simulate new alert` to see the forecast and plan update. - Open the collapsible `Incoming data` section for the local alert API. - Click `Play voice prompt` for the non-reader workflow. - Click `Send SMS digest` to dry-run SMS delivery into the local outbox. ## Command-Line Demo ```bash python run_demo.py --business salon ``` This regenerates the synthetic …