CoolFace
Apppublic

thevikramrajput/ai-feedback-analyzer

sourceHugging Faceupdated 6mo agoView on Hugging Face
0likes
App README

AI Product Feedback Analyzer

A production-style AI system that converts raw user reviews into actionable product insights using NLP and pre-trained models.

๐Ÿ”— Live Demo: Hugging Face Spaces

๐ŸŽฏ Problem Statement

Product teams cannot manually read thousands of user reviews. They need an automated system to:

  • โ€”Understand overall user sentiment
  • โ€”Discover the main complaint categories
  • โ€”Prioritize issues based on frequency and impact
  • โ€”Get AI-generated summaries of what users are saying

๐Ÿš€ Solution

An end-to-end AI pipeline that:

  1. 1.Loads Google Play Store reviews from CSV
  2. 2.Preprocesses text (cleaning, filtering English reviews)
  3. 3.Analyzes sentiment based on star ratings
  4. 4.Clusters negative reviews to discover complaint patterns
  5. 5.Generates AI summaries using HuggingFace Inference API (BART-large-CNN)
  6. 6.Visualizes everything in a product analytics dashboard

โœจ Features

FeatureDescription
Sentiment AnalysisClassify reviews as positive, neutral, or negative
Topic ClusteringKeyword-based clustering for complaint categories
AI SummarizationHuggingFace Inference API (BART-large-CNN) generates summaries
Category-wise ReviewsView ALL reviews in each complaint category
Interactive DashboardProfessional Streamlit UI with charts and filters
Filter SupportFilter by sentiment, app, and view all reviews

๐Ÿค– AI-Powered Summary

Click "Generate Detailed AI Summary" to get:

  • โ€”Overall Summary - AI-generated summary of all reviews
  • โ€”What Users Are Complaining About - Summary of negative feedback
  • โ€”What Users Love - Summary of positive reviews
  • โ€”Category-wise Summaries - Login issues, bugs, feature requests, messaging
  • โ€”Actual User Quotes - Real complaints and praises
  • โ€”Action Items - Recommendations based on user feedback

๐Ÿ› ๏ธ Tech Stack

TechnologyPurpose
Python 3.9+Core language
StreamlitDashboard UI
FastAPIBackend API (local)
Pandas, NumPyData processing
scikit-learnKMeans clustering
HF Inference APIBART-large-CNN for AI summarization
PlotlyInteractive charts

๐Ÿ“ Project Structure

ai-feedback-analyzer/
โ”œโ”€โ”€ app.py               # Main Streamlit app (HF Spaces)
โ”œโ”€โ”€ requirements.txt     # Dependencies
โ”œโ”€โ”€ data/
โ”‚   โ””โ”€โ”€ Training_Data.csv
โ”œโ”€โ”€ backend/             # FastAPI (local dev)
โ”‚   โ”œโ”€โ”€ app.py
โ”‚   โ”œโ”€โ”€ data_loader.py
โ”‚   โ”œโ”€โ”€ preprocess.py
โ”‚   โ”œโ”€โ”€ sentiment.py
โ”‚   โ”œโ”€โ”€ clustering.py
โ”‚   โ””โ”€โ”€ insights.py
โ””โ”€โ”€ frontend/
    โ””โ”€โ”€ app.py           # Streamlit (local dev)

โšก Quick Start

Hugging Face Spaces (Recommended)

Visit: https://huggingface.co/spaces/thevikramrajput/ai-feedback-analyzer

Local Development

bash
# Install dependencies
pip install -r requirements.txt

# Run Streamlit app
streamlit run app.py

With Backend API (Optional)

bash
# Terminal 1: Start API
cd backend
uvicorn app:app --reload --port 8000

# Terminal 2: Start Dashboard
cd frontend
streamlit run app.py

๐Ÿ“Š Dashboard Features

  • โ€”KPI Cards - Total reviews, positive/negative %, health score
  • โ€”Sentiment Pie Chart - Visual sentiment distribution
  • โ€”Top Issues Bar Chart - Most frequent complaint categories
  • โ€”AI Summary Section - Detailed insights from reviews
  • โ€”Reviews by Category - View ALL reviews in each category
  • โ€”All Reviews Table - Complete filterable review list

๐Ÿ“ CSV Format

Your CSV should have these columns:

  • โ€”content - Review text (required)
  • โ€”score - Star rating 1-5 (required)
  • โ€”userLang - Language code (optional)
  • โ€”app_id - App identifier (optional)

๐Ÿ”ฎ Future Improvements

  • โ€”[ ] Multilingual support
  • โ€”[ ] Time-series trend analysis
  • โ€”[ ] Competitor comparison
  • โ€”[ ] Export to PDF/Excel
  • โ€”[ ] Custom LLM integration