QUASAR378/INTELLIX

Stars of Innovation - US Kenya AI Challenge # INTELLIX - Kenya Energy Dashboard (umeme AI) 🚀 **"Equitable Energy for Every Kenyan"** A comprehensive AI-driven energy dashboard for Kenya's counties, featuring interactive maps, mini-grid simulations, and intelligent energy recommendations to guide renewable energy investments. ## 🌟 **Key Features** - **Interactive County Map**: Click any of Kenya's 47 counties for instant analysis - **AI-Powered Recommendations**: Claude/Gemini integration with rule-based fallback - **Real-time Mini-Grid Simulation**: 24-hour energy generation vs. demand modeling - **Investment Analysis**: ROI calculations and cost-benefit analysis - **Automated Demo Flow**: One-click testing with `./test_enhanced_flow.sh` ## 🚀 **Quick Start** ### **Prerequisites** - Python 3.8+ - Node.js 16+ - npm or yarn ### **1. Clone & Setup** ```bash git clone cd Energy-Hackathon ``` ### **2. Backend Setup** ```bash cd backend pip install -r requirements.txt ``` ### **3. Frontend Setup** ```bash cd ../frontend npm install ``` ### **4. Environment Configuration (Optional)** ```bash # Copy environment template cp .env.example .env # Edit .env with your API keys (optional - has fallback system) nano .env ``` ### **5. Run the Demo** ```bash # From project root chmod +x test_enhanced_flow.sh ./test_enhanced_flow.sh ``` **That's it!** Go to localhost and click any county on the map! ## 🔐 **API Keys (Optional)** The system works perfectly without API keys using our intelligent rule-based fallback. For enhanced AI analysis, you can add: - **ANTHROPIC_API_KEY**: Claude AI integration - **GOOGLE_AI_API_KEY**: Gemini AI integration Add these to your `.env` file (never commit API keys to git!). ## Project Structure ``` Energy-Hackathon/ ├── 📁 frontend/ # React Application │ ├── 📁 public/ │ │ ├── index.html │ │ └── kenya-counties.geojson # Kenya map data │ ├── 📁 src/ │ │ ├── 📁 components/ │ │ │ ├── KenyaMap.jsx # Interactive map component │ …