FRANKMAKORI/kenya-sentiment-insights

🇰🇪 AI-powered dashboard that analyzes public sentiment in Kenya using live news, Python, and Streamlit. ```markdown # 🇰🇪 Kenya Sentiment & Policy Analytics Dashboard > 🧠 AI-powered analytics dashboard visualizing **public sentiment and media trends in Kenya** — powered by **Streamlit**, **Google News**, and **TextBlob** for sentiment analysis. --- ## 🌍 Project Overview The **Kenya Sentiment & Policy Analytics Dashboard** provides a real-time, AI-driven look at how Kenyan news and public media reflect national sentiment on key social, political, and economic topics. It combines: - 📰 **News scraping** (Google News) - 🧠 **AI-powered sentiment analysis** - 📊 **Interactive Streamlit visualizations** --- ## 🧩 Features ✅ Real-time data collection from Google News ✅ Sentiment analysis using `TextBlob` ✅ Interactive dashboards (charts, filters, and summaries) ✅ One-click data refresh inside Streamlit ✅ Clean modular Python project structure --- ## 🏗️ Project Structure ``` kenya-sentiment-insights/ │ ├── data/ │ ├── raw/ # Unprocessed scraped data │ └── processed/ # Cleaned and analyzed data │ ├── src/ │ ├── data_collection/ # Scripts for news scraping │ │ └── scrape_news.py │ ├── sentiment_analysis/ # Sentiment processing │ │ └── analyze_sentiment.py │ └── dashboard/ # Streamlit visualization │ └── app.py │ ├── requirements.txt ├── README.md └── .streamlit/ └── config.toml ```` --- ## ⚙️ Installation & Setup ### 🖥️ 1. Clone the repository ```bash git clone github.com cd kenya-sentiment-insights ```` ### 🧱 2. Create a virtual environment ```bash python -m venv .venv .\.venv\Scripts\activate # Windows ``` ### 📦 3. Install dependencies ```bash pip install -r requirements.txt ``` ### 📰 4. Collect news data ```bash python src/data_collection/scrape_news.py ``` ### 🧠 5. Analyze sentiment ```bash python src/sentiment_analysis/analyze_sentiment.py ``` ### 📊 6. Run the dashboard ```bash streamlit run src/dashboard/app.py ``` --- ## 🚀 Liv …