Filimon-H/Forecasting-Financial-Inclusion-in-Ethiopia

# Forecasting Financial Inclusion in Ethiopia A forecasting system that tracks Ethiopia's digital financial transformation using time series methods, built for the 10 Academy Week 10 Challenge. ## Project Overview This project builds a forecasting system to predict Ethiopia's progress on two core dimensions of financial inclusion as defined by the World Bank's Global Findex: - **Access** — Account Ownership Rate - **Usage** — Digital Payment Adoption Rate The system analyzes how events like product launches, policy changes, and infrastructure investments affect inclusion outcomes, and forecasts Access and Usage for 2025-2027. ## Project Structure ``` ethiopia-fi-forecast/ ├── .github/workflows/ │ └── unittests.yml # CI/CD pipeline ├── data/ │ ├── raw/ # Starter dataset │ │ ├── ethiopia_fi_unified_data.csv │ │ └── reference_codes.csv │ └── processed/ # Analysis-ready data │ └── ethiopia_fi_unified_data_enriched.csv ├── notebooks/ │ ├── 01_data_exploration_enrichment.ipynb │ └── 02_exploratory_data_analysis.ipynb ├── src/ # Source code modules ├── dashboard/ │ └── app.py # Streamlit dashboard ├── tests/ # Unit tests ├── models/ # Trained models ├── reports/ │ └── figures/ # Generated plots ├── requirements.txt # Python dependencies ├── data_enrichment_log.md # Documentation of data additions ├── r.md # Schema design documentation ├── ch.md # Challenge requirements └── README.md # This file ``` ## Quick Start ### 1. Environment Setup ```bash # Clone the repository git clone cd Forecasting-Financial-Inclusion-in-Ethiopia # Create virtual environment python3 -m venv .venv source .venv/bin/activate # Install dependencies pip install -r requirements.txt ``` ### 2. Run Analysis Notebooks ```bash # Start Jupyter jupyter notebook # R …