LivePulse / README.md
DivYonko
Replace ML ensemble with pure keyword sentiment engine
b9d31ba
---
title: LivePulse
emoji: πŸ“‘
colorFrom: purple
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
short_description: YouTube Live Chat Analytics
---
# πŸ“‘ LivePulse β€” YouTube Live Chat Analytics
Real-time Hinglish sentiment and topic analysis for YouTube live streams.
## Features
- Real-time chat scraping via YouTube Data API v3
- Sentiment classification (Positive / Neutral / Negative) using a pure keyword engine
- Expanded Hinglish + English + regional slang keyword sets
- Negation handling ("nahi accha" β†’ Negative)
- Intensifier boost ("bahut accha" β†’ higher confidence)
- Emoji sentiment scoring
- Topic classification (Appreciation / Question / Promo / Spam / MCQ Answer / General)
- Action type classification (28 fine-grained categories, fully keyword-based)
- Interactive Streamlit dashboard with live auto-refresh
- Start/stop scraper directly from the UI
- Multi-stream comparison (up to 5 streams)
- Engagement score, word cloud, leaderboard, sentiment heatmap
## Usage
1. Paste a YouTube live video ID or URL in the **Stream Control** section in the sidebar
2. Click **β–Ά Start** β€” the scraper launches in the background
3. The dashboard auto-refreshes and shows live sentiment + topic data