RonnieZad/uganda-loan-platform

# Uganda Financial Services - Loan Eligibility Assessment Platform Machine Learning-powered loan eligibility platform with Uganda-specific financial data and professional banking interface. Built with FastAPI, React, and Scikit-learn. ## Features ### Core Capabilities - **Instant Decision Making**: Process loan applications in under 3 minutes - **120+ Behavioral Features**: Advanced feature engineering across 7 thematic categories - **Multiple ML Models**: Logistic Regression, Random Forest, XGBoost, LightGBM, Neural Networks (FFN, LSTM) - **Fairness & Interpretability**: SHAP and LIME explanations for transparent decision-making - **Real-time API**: FastAPI-based REST API for seamless integration - **Modern Frontend**: React-based user interface for applicants and loan officers ### Technical Highlights - **High Accuracy**: >88% prediction accuracy with AUC-ROC >0.85 - **Scalable Architecture**: Microservices design with Docker containerization - **Production-Ready**: PostgreSQL database, Redis caching, monitoring with Prometheus/Grafana - **Security First**: Encryption at rest and in transit, RBAC, audit logging - **Automated Retraining**: Monthly model updates with feedback loops ## Architecture ``` ┌─────────────────┐ │ React Frontend │ └────────┬────────┘ │ ▼ ┌─────────────────┐ ┌──────────────┐ │ FastAPI API │◄────►│ Redis Cache │ └────────┬────────┘ └──────────────┘ │ ├──────────────────┐ │ │ ▼ ▼ ┌──────────────┐ ┌──────────────────┐ │ PostgreSQL │ │ ML Model Engine │ │ Database │ │ (Prediction & │ └──────────────┘ │ Explanation) │ └──────────────────┘ │ ▼ ┌──────────────────┐ │ Monitoring Stack │ │ (Prometheus + │ │ Grafana) │ └──────────────────┘ ``` ## Quick Start ### Prerequisites - Python 3.9+ - Docker & Docker Compose - Node.js 16+ (for frontend) ### Installation 1. **Clone the repository** ```bash git clone cd credit_score ``` 2. **Set up environment variables* …