SentimentStream — Real-Time Social Media Sentiment Analysis

📡
NLP / Streaming

A real-time social media sentiment analysis platform monitoring simulated tweet streams, classifying sentiment, clustering topics, and detecting emerging trends.

Live Preview

Interactive preview — open in full window for the best experience

Technology Stack

Python 3.11FastAPINLP EngineWebSocketSQLAlchemyDocker

Key Features

  • Live Tweet Stream — Continuous realistic simulated tweets with hashtags and mentions
  • Sentiment Classification — Positive / negative / neutral with confidence scores
  • Topic Clustering — Groups tweets by keyword frequency and co-occurrence
  • Trend Detection — Identifies volume spikes, sentiment shifts, and emerging topics
  • Auto-Refresh Dashboard — Live stream with sentiment gauge and topic bubbles
  • Custom Text Analysis — Analyze any text for sentiment and extract topics
  • Twitter-Inspired UI — Blue theme with real-time streaming aesthetics
  • REST API — Full JSON API for programmatic access

About This Project

Fully open source (MIT License), containerized with Docker, and includes a CI/CD pipeline via GitHub Actions. Demonstrates production-grade Python development with comprehensive test coverage, clean architecture, and professional deployment.