# 🌍 AI-Powered GDP Calculator
Real-time AI platform that estimates Burundi's informal economy GDP using **Google Cloud Vertex AI** and **Elasticsearch** with multi-source data fusion.
## 🏆 Hackathon Compliance
- âś… **Google Cloud Gemini AI** - Enhanced ML predictions
- âś… **Elasticsearch** - Partner Challenge requirement
- âś… **AI Innovation** - Real-time economic insights
## 🚀 Quick Start
```bash
# Install dependencies
source venv/bin/activate
pip install -r requirements.txt
# Start system
./start.sh
```
**Access:**
- **Dashboard**:
localhost
- **API**:
localhost
## 🎯 **DEMO READY - 2 Minute Demo:**
### **1. Show Compliance** (30s)
localhost → Shows Google Cloud + Elasticsearch
### **2. Live Predictions** (30s)
localhost → Real-time GDP with Gemini AI
### **3. Search Feature** (30s)
Dashboard Sidebar → Search provinces with Elasticsearch
### **4. 12-Month Forecast** (30s)
Dashboard Sidebar → AI-powered forecasting
## 📊 Features
- **Google Cloud Gemini AI** enhanced GDP predictions
- **Real-time GDP estimation** using 5 data sources
- **Elasticsearch** for scalable search & analytics
- **Interactive dashboard** with live charts
- **12-month forecasting** with AI confidence scoring
- **Province search** functionality
- **RESTful API** for data access
## 🏗️ Architecture
```
Data Sources → Fusion Engine → Google Cloud Vertex AI → Elasticsearch → API → Dashboard
```
## đź”§ Technology Stack
### **Google Cloud Integration**
- **Gemini AI** - Enhanced ML predictions
- **AI-powered insights** generation
- **Confidence scoring** algorithms
### **Partner Challenge**
- **Elasticsearch** - Data storage & search
- **Real-time indexing**
- **Advanced analytics**
## đź”§ API Endpoints
- `GET /health` - System health (includes Google Cloud status)
- `GET /predict` - Real-time GDP predictions with Gemini AI
- `GET /search` - Search province data in Elasticsearch
- `GET /forecast` - 12-month AI forecasting
- `GET /his …