Nemick/jua-smart-solar-advisor

Jua Smart (Jua means "sun" in Swahili) is an intelligent solar energy advisor designed specifically for Kenyan homes and businesses. Get AI-powered solar system recommendations with real EPRA tariffs, county-specific solar data, and accurate financial projections. # ☀️ Jua Smart - Solar Energy Advisor for Kenya **Jua Smart** (Jua means "sun" in Swahili) is an intelligent solar energy advisor designed specifically for Kenyan homes and businesses. Get AI-powered solar system recommendations with real EPRA tariffs, county-specific solar data, and accurate financial projections. --- ## ✨ Features - 🌍 **Kenya-Specific Data**: Real EPRA electricity tariffs (2024-2026) and county-by-county solar irradiance - 🤖 **AI-Powered Recommendations**: Detailed system designs powered by Google Gemini - 🔋 **Battery Calculator**: Compare Lithium (LiFePO4), Gel, and Lead-Acid batteries with automatic sizing - 📊 **Financial Projections**: 25-year ROI analysis, payback periods, and savings calculations - 📍 **NASA POWER Integration**: Get precise solar data for your exact location - ⚖️ **System Comparison**: Compare different system sizes side-by-side - 💬 **Chat Advisor**: Ask questions about solar energy in Kenya - 📥 **Export Reports**: Download your analysis for offline review --- ## 🚀 Quick Start ### Prerequisites - Python 3.9 or higher - Google Gemini API key (free tier available) ### Installation 1. **Clone the repository** ```bash git clone github.com cd jua-smart-solar-advisor ``` 2. **Create virtual environment** ```bash # Windows python -m venv venv .\\venv\\Scripts\\activate # macOS/Linux python3 -m venv venv source venv/bin/activate ``` 3. **Install dependencies** ```bash pip install -r requirements.txt ``` 4. **Set up API key** Create a `.env` file in the project root: ```bash cp .env.example .env ``` Get your free Gemini API key at: aistudio.google.com Add it to `.env`: ```env GEMINI_API_KEY=your_api_key_here ``` 5. **Run the app** ```bash streamlit run app.py ``` 6. **Open in browser** The app will automatically open at localhost --- ## 📖 How to Use ### Step 1: Input Your Energy Needs Choose your method: - **Monthly Bill**: Ent …