abenezer4/Ethiopia-Forecasting-Financial-Inclusion-

# Ethiopia Financial Inclusion Forecasting 🇪🇹 ## Overview This project aims to build a forecasting system that tracks Ethiopia's digital financial transformation using time series methods. ## Business Need Selam Analytics has been engaged to develop a financial inclusion forecasting system to understand drivers of financial inclusion and forecast Access and Usage for 2025-2027. ## Structure - `data/`: Contains raw and processed data. - `notebooks/`: Jupyter notebooks for analysis and modeling. - `src/`: Source code for data processing and modeling. - `dashboard/`: Streamlit dashboard application. - `models/`: Saved models. - `reports/`: Generated reports and figures. **A production-grade Machine Learning system to predict and explain financial inclusion in Ethiopia.** ## 📌 Features - **Modular Codebase:** Refactored into `src/` for maintainability. - **CI/CD Pipeline:** Automated testing via GitHub Actions. - **Interactive Dashboard:** Streamlit app for real-time predictions. - **Explainable AI:** SHAP integration to interpret model decisions. ## 🚀 Quick Start ```bash git clone cd Ethiopia-Forecasting-Financial-Inclusion- pip install -r requirements.txt streamlit run app.py ``` ## 📂 Structure - `src/`: Data processing and training modules. - `tests/`: Unit tests (run with `pytest`). - `.github/workflows/`: CI configuration.