Skip to content
Projects

ali-faraz-py/SentimentSense has 26 GitHub stars and 0 forks. Star changes are not measured yet. Last checked 2026-11-11 16:07 UTC. Last push 2026-07-25.

How these counts are measured

🧠 Sentiment Sense: Advanced NLP dashboard using DistilBERT & Zero-Shot (BART) for Aspect-Based Sentiment Analysis. Detects business topics (Food, Service, Price) & emotional context in real-time. Built for enterprise feedback processing. 🚀

What you can do

  • Dual-Model Pipeline: Combines a DistilBERT transformer for sentiment with a BART-Large model for zero-shot topic classification.
  • Aspect-Based Analysis (ABSA): Automatically identifies specific categories (Food, Service, Price, etc.) mentioned in the text without manual labeling.
  • Contextual Nuance: Correctively handles negations (e.g., "not great") and complex linguistic structures that traditional models miss.
  • Real-Time Inference: High-speed processing using optimized PyTorch backends.

Measured star growth

in 24h
Update delayed
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

🧠 Sentiment Sense: Advanced Aspect-Based Sentiment AI

A professional-grade Natural Language Processing (NLP) dashboard built with Python and Streamlit. This tool utilizes Transfer Learning via Hugging Face Transformers to perform simultaneous sentiment analysis and aspect extraction with high contextual awareness.


🚀 Live Demo

Click here to try the Live App


📺 Demo Preview

Sentiment Sense Demo


✨ Features

  • Dual-Model Pipeline: Combines a DistilBERT transformer for sentiment with a BART-Large model for zero-shot topic classification.
  • Aspect-Based Analysis (ABSA): Automatically identifies specific categories (Food, Service, Price, etc.) mentioned in the text without manual labeling.
  • Contextual Nuance: Correctively handles negations (e.g., "not great") and complex linguistic structures that traditional models miss.
  • Real-Time Inference: High-speed processing using optimized PyTorch backends.
  • Enterprise UI: Interactive metrics, progress bars, and sidebar technical documentation for an intuitive user experience.

🛠️ Tech Stack

  • Language: Python 3.12+
  • Framework: Streamlit (Web UI)
  • NLP Engines: Hugging Face Transformers
  • Deep Learning Framework: PyTorch
  • Models: distilbert-base-uncased & facebook/bart-large-mnli
  • Deployment: Streamlit Community Cloud

🚀 Installation & Local Setup

  1. Clone the repository:

    git clone [https://github.com/ali-faraz-py/SentimentSense](https://github.com/ali-faraz-py/SentimentSense)
    cd SentimentSense
    
  2. Install dependencies:

     pip install -r requirements.txt
    
  3. Run the application:

     streamlit run app.py
    

📂 Project Structure

sentimentsense/
├── app.py              # Main Streamlit application and dual-model logic
├── requirements.txt    # Project dependencies (Transformers, Torch, Streamlit)
├── .gitignore          # Prevents tracking of cache and environment files
└── explore.ipynb       # Initial research on LSTM-based sentiment analysis

🧠 Model Insights

The engine moves beyond simple "keyword matching" by using Self-Attention mechanisms.

  • The Sentiment Stage: Uses DistilBERT, which was trained on the SST-2 dataset, allowing it to achieve 90%+ accuracy on general sentiment tasks while remaining lightweight.
  • The Aspect Stage: Uses Zero-Shot Classification (BART). This allows the app to detect any custom category (like "Atmosphere" or "Health") by measuring the semantic similarity between the input text and the target labels.

👤 Author

Syed Ali Faraz - GitHub Profile

If you found this NLP pipeline useful, please give the repository a ⭐!

Explore related projects