README.md

metadata

title: Book Recommender
emoji: 👁
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.6.0
app_file: app.py
pinned: false
short_description: 'Book search/rec based on vector search: Query - Book desc'

📚 Semantic Book Recommender

A semantic book recommendation system powered by vector search and emotion-aware ranking.

🚀 How It Works

1. User enters a book description.
2. The query is converted into an embedding using
   sentence-transformers/all-MiniLM-L6-v2 (Hugging Face Inference API).
3. FAISS performs cosine similarity search over precomputed book embeddings.
4. Results are optionally filtered by category.
5. Results are optionally re-ranked by emotional tone (joy, surprise, anger, fear, sadness).

---

🧠 Features

• Semantic similarity search (FAISS)
• Emotion-based re-ranking
• Category filtering
• Fast retrieval with precomputed embeddings
• Hosted on Hugging Face Spaces (Gradio)

---

🛠 Tech Stack

• Python
• Gradio
• FAISS
• Hugging Face Inference API
• Pandas / NumPy

---