abdulrahman-sharif0/egypt-real-estate-predictor
Domain:
socioeconomicRecord type:
modelsoftware
Creator:
abd
Host:
🏠 AI-Powered Egyptian Real Estate Price Predictor | XGBoost Model (R² = 0.65) | Streamlit Web App
# 🏠 Egypt Real Estate Price Predictor
AI-Powered Property Valuation Using XGBoost Regression
Predict real estate prices across Egypt with 95% confidence intervals | Trained on 15,791 listings
---
## 📋 Table of Contents
- 🌟 Features
- 🛠️ Tech Stack
- 📊 Dataset
- 🚀 Quick Start
- 📁 Project Structure
- 🤖 Model Performance
- 🎯 How It Works
- 📈 Calibration System
- 🔧 Data Pipeline & Cleaning
- 🤝 Contributing
- 🙏 Acknowledgments
- 📄 License
---
## 🌟 Features
### **For Users (Web App)**
- ✅ **Smart Price Prediction** - AI-powered estimates using XGBoost regression
- ✅ **113+ Locations** - Coverage across Cairo, Alexandria, North Coast, Red Sea & more
- ✅ **18 Property Types** - Apartments, Villas, Chalets, Penthouses, iVillas, etc.
- ✅ **Payment Method Adjustment** - Cash vs Installments pricing (+15% premium for installments)
- ✅ **95% Confidence Intervals** - Statistical uncertainty ranges (±4.9M EGP)
- ✅ **Smart Calibration** - Corrects model bias for realistic market prices
- ✅ **Responsive Design** - Beautiful dark theme UI optimized for mobile & desktop
### **For Developers (Code & Research)**
- ✅ **Complete ML Pipeline** - Data cleaning → Feature engineering → Training → Evaluation → Deployment
- ✅ **4 Trained Models Compared** - Linear Regression, KNN, Random Forest, XGBoost
- ✅ **Production Ready** - Streamlit Cloud deployment ready with requirements.txt
- ✅ **Well Documented** - Jupyter notebook with step-by-step explanations
- ✅ **Reproducible** - Full dataset + cleaning code included for retraining
- ✅ **Open Source** - MIT License, free to use and modify
---
## 🛠️ Tech Stack
### **Machine Learning**
| Technology | Version | Purpose |
|------------|---------|---------|
| | 2.0+ | Primary regression model (best performer) |
| | 1.9.0 | Preprocessing, feature engineering, model evaluation |
| | 2.0+ | Data manipulation & cleaning |
| | 1.24+ | Numerical operations |
| | 1.10+ | Sparse matrix handling |
### **Web Application**
| Tec …