abdulrahman-sharif0/egypt-real-estate-predictor

🏠 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 …