muhinja2002-svg/market-pulse-dashboard

Live African economic dashboard — World Bank API + Streamlit + Plotly. Deployed on Streamlit Cloud. # Market Pulse — Africa Economic Dashboard A live, interactive dashboard that pulls real-time economic and development indicators for 9 African countries using the **World Bank Open Data API** — zero static CSV files. 🔴 **Live App →** *(replace with your Streamlit Cloud URL after deploying)* --- ## Features - **Live API data** — no CSV files, all data fetched fresh from World Bank - **10 economic indicators** — GDP, inflation, unemployment, mobile/internet penetration, electricity access, and more - **9 African countries** — Kenya, Nigeria, South Africa, Ghana, Ethiopia, Tanzania, Uganda, Rwanda, Senegal - **Time-series trend charts** with up to 25 years of history - **Cross-country bar chart** comparison mode - **KPI metric cards** showing current value, YoY delta, and long-run change - **Caching** — API responses cached for 1 hour to keep it fast --- ## How to Run Locally ```bash git clone github.com cd market-pulse-dashboard pip install -r requirements.txt streamlit run src/app.py ``` Open `localhost` in your browser. --- ## Deploy to Streamlit Cloud (Free) 1. Push this repo to GitHub (public) 2. Go to share.streamlit.io → **New app** 3. Set **Main file path** to `src/app.py` 4. Click **Deploy** — live in ~2 minutes --- ## Skills Demonstrated - REST API integration (`requests`, JSON parsing, query params) - Streamlit app architecture (layout, sidebar, caching with `@st.cache_data`) - Interactive visualisation with Plotly (area charts, horizontal bar charts) - Pandas for data transformation - Deploying a Python web app to the cloud --- *Rawlings Muhinja · muhinja2002@gmail.com · datascienceportfol.io