Nemick/jua-smart-solar-advisor
Domain:
environment and energyRecord type:
software
Creator:
Nem
Host:
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 …