Skip to content

Latest commit

Β 

History

History
44 lines (33 loc) Β· 1.23 KB

File metadata and controls

44 lines (33 loc) Β· 1.23 KB

πŸ›οΈ Book Recommender

A semantic book recommender finding reads by meaning and emotion. This project was developed as part of the challenges for the MLH Data Week.


πŸ“Έ Preview

Interface Results
App Screenshot 1 App Screenshot 2

🧠 Logic

The system processes the 7k books Kaggle dataset through two primary layers:

  1. Semantic Search: Uses LangChain and ChromaDB to interpret user intent beyond simple keyword matching.
  2. Sentiment Analysis: Classifies descriptions into 7 emotional tones:
    • 😑 Anger | 🀒 Disgust | 😨 Fear | 😊 Joy | 😒 Sadness | 😲 Surprise | 😐 Neutral

πŸ“‚ Pipeline

  • Data Cleaning: Standardizing raw Kaggle metadata.
  • Sentiment Logic: Emotional tagging of book descriptions.
  • Semantic Engine: Vector indexing for contextual retrieval.
  • UI Layer: Interactive dashboard via Gradio.

πŸ› οΈ Tech Stack

  • AI: LangChain & HuggingFace
  • Database: ChromaDB
  • Data: Pandas & Numpy
  • Tooling: Managed with uv

πŸš€ Setup

git clone https://github.com/Tek233/Book-Recommender.git
cd book-recommender
uv sync
uv run app.py