Skip to content

Releases: MomenMushtaha/ReviewLensAI

🚀 ReviewLens AI v1.0.0 — Initial Release

15 Mar 04:32
@MomenMushtaha MomenMushtaha
v1.0.0
d60ef47

Choose a tag to compare

View all tags
🚀 ReviewLens AI v1.0.0 — Initial Release Latest
Latest

🎉 ReviewLens AI v1.0.0 — Initial Release

ReviewLens AI is an AI-powered review intelligence portal that transforms raw Trustpilot reviews into actionable insights. Paste a URL or upload a CSV, and get sentiment analysis, theme clustering, rating trends, and a guardrailed Q&A chat — all in minutes.

🌐 Live Demo: v0-review-lens-ai.vercel.app
📡 API Docs: reviewlens-api.onrender.com/docs

✨ Features

  • Trustpilot Scraper — __NEXT_DATA__ extraction with JSON-LD fallback, paginated multi-page scraping, and CSV upload support
  • Smart Deduplication — SHA-256 hash of (source_url + body[:200]), scoped per project
  • Sentiment Analysis — VADER compound score with star-rating override for extreme ratings (1–2★ → negative, 4–5★ → positive)
  • Theme Discovery — TF-IDF vectorization + KMeans clustering (up to 8 themes) with guaranteed sentiment diversity
  • AI Summaries — OpenAI tool-use API generates labeled themes and an executive brief
  • Rating Trends — Monthly average rating and review volume charts via Recharts
  • Guardrailed Chat — 3-layer guardrail (regex pre-filter, system prompt boundary, hallucination scan) keeps responses grounded in review data
  • RAG Retrieval — pgvector cosine similarity search over 384-dimensional sentence embeddings
  • Real-time Progress — Server-Sent Events stream pipeline status to the frontend
  • Review Browser — Sortable, paginated review table with sentiment badges and star ratings

🏗️ Tech Stack

Layer Technology
Backend Python 3.11, FastAPI (fully async), Alembic migrations
Database Supabase PostgreSQL + pgvector
Embeddings all-MiniLM-L6-v2 via sentence-transformers (local, free)
LLM GPT-4o-mini via OpenAI API
Sentiment VADER (local, no API cost) with star-rating override
Clustering scikit-learn TF-IDF + KMeans
Frontend Next.js 14, Tailwind CSS, Recharts
Deployment Render (backend Docker) + Vercel (frontend)

🔧 Getting Started

# Backend
cd backend && python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # fill in DATABASE_URL and OPENAI_API_KEY
alembic upgrade head && uvicorn app.main:app --reload

# Frontend
cd frontend && npm install
cp .env.local.example .env.local  # set NEXT_PUBLIC_API_URL
npm run dev

Open http://localhost:3000 to start analyzing reviews.

📦 What's Changed

  • Update README with Vercel v0 transition note by @MomenMushtaha in #1
  • Update README with Vercel v0 transition details by @MomenMushtaha in #2
  • feat: async OpenAI, tests, metadata — Claude Code is back by @MomenMushtaha in #8
  • Improve reviews UX, theme analysis, and home page by @MomenMushtaha in #9
  • chore(deps): bump python-multipart from 0.0.12 to 0.0.22 in /backend by @dependabot[bot] in #10
  • chore(deps): bump next from 14.2.35 to 15.5.10 in /frontend by @dependabot[bot] in #11

🆕 New Contributors

Full Changelog: https://github.com/MomenMushtaha/ReviewLensAI/commits/v1.0.0

Contributors

dependabot and MomenMushtaha
Assets 2
Loading