# 🇪🇹 Ethiopia Financial Inclusion Forecast & Analysis
## 📌 Project Overview
This project transforms raw financial data and news-sourced events into an analytical dashboard. It addresses the challenge of sparse historical data (Findex points) by augmenting traditional trend lines with "shocks" derived from major policy and infrastructure events.
### Key Components:
* **Event-Indicator Association**
* Quantifies the impact of events (e.g., Telebirr launch, Digital ID rollout) using a "Fuzzy ID" mapping logic.
* Generates an **Association Matrix** that shows how different triggers affect specific National Financial Inclusion Strategy (NFIS) indicators.
* **Forecasting Access & Usage**
* Predicts **Account Ownership** and **Digital Payment Usage** for 2025–2027.
* Provides three scenarios: **Optimistic, Base, and Pessimistic** to quantify uncertainty.
* **Interactive Dashboard**
* Built with **Streamlit**, providing stakeholders with a visual interface to explore metrics, trends, and projections.
---
## 🚀 How to Run the Project
### 1. Prerequisites
Ensure you have Python 3.9+ installed and the required libraries:
```bash
pip install -r requirements.txt
```
### 3. Launching the Dashboard
Navigate to your project folder and run the following command:
```bash
# From the root directory
streamlit run dashboard/app.py