# Kenya Business Intelligence Tool
A local-first Python intelligence tool for analyzing business opportunities by location in Kenya.
## Goal
Build a practical data pipeline:
1. Collect data
2. Store raw data
3. Clean data
4. Normalize records
5. Score business opportunities
6. Expose results through an API
7. Present insights in a frontend dashboard
## Current stage
Boilerplate 001: Project foundation.
## Run locally
```bash
source .venv/bin/activate
python run.py
Project structure
app/
core/ configuration and shared utilities
cli/ command-line entry points
storage/ database and persistence logic
cleaning/ data cleaning pipeline
scraping/ web scraping modules
intelligence/ scoring and recommendation logic
api/ backend API
data/
raw/ untouched source data
processed/ cleaned/transformed data
exports/ reports and final outputs
frontend/ dashboard frontend
config/ local configuration files
scripts/ helper scripts
tests/ automated tests
logs/ local logs