WagaOruoch/Kenya-Counts

# Kenya Counts **"The Devolution Dividend — Has Kenya's Tax Money Worked for Its People?"** *Eleven years of taxation. Forty-seven counties. One question: what did Kenyans actually get?* --- ## What This Is A data-driven investigation into whether Kenya's tax revenue — collected since devolution began in 2013 — has translated into meaningfully better and more equally distributed public services for ordinary citizens. This project scrapes public data from government sources, cleans and merges it into analysis-ready datasets, and tells the story through notebooks, an interactive dashboard, and a written report. ## The Question > Has Kenya's tax money — collected since devolution in 2013 — translated into meaningfully better and more equally distributed public services for ordinary citizens? Read the full question framing: QUESTION.md ## The Story The project tells its story in four acts: 1. **The Promise** — What devolution was supposed to deliver 2. **The Ledger** — Following the money at the national level 3. **The Divide** — How 47 counties experienced devolution differently 4. **The Verdict** — What the data says, what it can't say, and what should happen next Read the full narrative outline: STORY.md ## Project Structure See DIRECTORY.md for the full annotated folder structure. Key layers: - **`scraper/`** — Collects data from KRA, National Treasury, Controller of Budget, KNBS, CRA, CBK, and the World Bank API - **`pipeline/`** — Validates, cleans, merges, and computes derived indicators - **`notebooks/`** — EDA, analysis, and story visualisations - **`dashboard/`** — Interactive Streamlit app for exploring the data - **`report/`** — Auto-generated PDF of the final story ## Quick Start ```bash # Clone the repository git clone github.com cd kenya-counts # Create a virtual environment python -m venv .venv source .venv/bin/activate # Linux/Mac .venv\Scripts\activate # Windows # Install dependencies pip in …