Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Magnifying Glass

✨ ReviewLens ✨

AI-Powered Product Review Analysis & RAG Engine

FastAPI Next.js TypeScript FAISS Tailwind CSS

Turn thousands of noisy reviews into instant, actionable insights with Semantic Search and AI Summarization.

FeaturesTech StackQuick StartArchitecture


🌟 Why ReviewLens?

Shopping online is overwhelming. Digging through thousands of reviews to figure out if a product's battery actually lasts or if the seller is legitimate takes hours.

ReviewLens solves this. With an elegant Next.js dashboard, a FastAPI AI brain, and a seamless Chrome Extension, ReviewLens reads the reviews for you. It extracts pros and cons, detects fake reviews, analyzes sentiment by feature, and even lets you chat with the reviews using our RAG (Retrieval-Augmented Generation) engine.

Star Struck

✨ Key Features

🧠 Semantic RAG Search

Stop guessing keywords. Ask natural questions like "How is the battery life after a year?" or "Is the screen good for gaming?" Our FAISS-powered vector search finds the exact context across thousands of reviews and generates a precise answer using Groq LLM.

🔗 "Analyze By URL" Intelligence

Just paste any Amazon or Flipkart URL. ReviewLens seamlessly scrapes the product page, analyzes the extracted reviews, and generates a beautiful dashboard of insights. If a site uses heavy JavaScript blocking, the backend fails over gracefully to smart LLM-based product heuristics.

📊 Aspect-Based Sentiment Analysis

Don't just look at the average rating. ReviewLens automatically identifies key product features (e.g., Battery, Performance, Display) and rates the sentiment specifically for those features.

🚩 Fake Review Detection

Shop safely. Our heuristic engine flags suspicious review patterns, generic phrasing, and massive sentiment outliers.

🔌 1-Click Chrome Extension

A companion tool that detects product pages on eCommerce sites. Click the floating magic button to instantly jump to a deep-dive analysis of that exact product.


🛠️ Tech Stack

Section Technologies
Backend (The Brain) 🐍 FastAPI, 🔍 FAISS, 🧠 Groq LLM, 📊 Sentence-Transformers, 📝 TextBlob, 🐼 Pandas
Frontend (The UI) ⚡ Next.js 14, 📘 TypeScript, 🎨 Tailwind CSS, 📈 Chart.js
Extension (The Bridge) 🧩 Manifest V3, 📜 Vanilla JS (Service Workers & Content Scripts)

🚀 Quick Start

Get ReviewLens running locally in minutes.

1️⃣ Clone & Backend Setup

git clone https://github.com/yourusername/ReviewLens.git
cd ReviewLens

# Install Python dependencies in the root environment
pip install -r backend/requirements.txt

# Create your .env file
echo "GROQ_API_KEY=your_api_key_here" > backend/.env

# Start the AI Backend
cd backend
python -m uvicorn main:app --reload --port 8000

The API will be live at http://localhost:8000

2️⃣ Frontend Setup

# Open a new terminal
cd ReviewLens/frontend

# Install dependencies
npm install

# Start the stunning Next.js UI
npm run dev

The Dashboard will be live at http://localhost:3000

3️⃣ Chrome Extension Install

  1. Open Chrome and navigate to chrome://extensions/
  2. Toggle on Developer mode in the top right corner.
  3. Click Load unpacked and select the /chrome-extension directory from the cloned repo.
  4. Open an Amazon/Flipkart product page to see the magic widget!

📂 Project Architecture

ReviewLens/
├── 🧠 backend/ 
│   ├── routes/          # Fast API endpoints (/analyze-url, /rag)
│   ├── services/        # AI, FAISS, Scraping, LLM orchestrators
│   └── models/          # Pydantic validation schemas
│
├── 💻 frontend/ 
│   ├── app/             # Next.js 14 App Router (Dashboard, Analyze)
│   ├── components/      # Sleek, glassmorphism UI parts
│   └── lib/             # API clients & TypeScript definition types
│
├── 🧩 chrome-extension/ # MV3 Service Workers & Content injection
│
└── 📄 README.md         # You are here!

Waving Hand

Built with 💜 by the ReviewLens Team

Transforming eCommerce, one review at a time.

About

Smart Retail Assistant: Build a tool that uses AI to analyze customer reviews or product data to provide instant, honest "Pros vs. Cons" summaries for shoppers.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages