How somaiyassine/book-recommender- works
Semantic Book Recommender is a local book-discovery application. Its documented workflow cleans book metadata, prepares searchable descriptions, adds category and emotion annotations, then serves semantic recommendations through a Gradio interface. The dashboard retrieves candidates by vector similarity, maps ISBNs to book records, applies optional category filtering and tone sorting, and displays covers and captions. Notebook internals are not sampled; their stages and data handoffs are represented from the README, while dashboard interactions are grounded in the excerpted Python source.
Main entry points: gradio-dashboard.py Gradio dashboard · vector-search.ipynb Vector index · books_cleaned.csv Cleaned books · tagged_description.txt Tagged descriptions
Components 16
Data preparation
- Metadata cleaning
data-exploration.ipynb - Kaggle books
- Cleaned books
books_cleaned.csv
Book enrichment
- Category classification
text-classification.ipynb - Categorized books
books_with_categories.csv - Emotion scoring
sentiment-analysis.ipynb - Emotion-scored books
books_with_emotions.csv
Semantic search
- ISBN descriptions
vector-search.ipynb - Tagged descriptions
tagged_description.txt - Text embeddings
vector-search.ipynb - Vector index
vector-search.ipynb
Recommendation app
- Gradio dashboard
gradio-dashboard.py - Recommendation handler
gradio-dashboard.py - Gallery formatting
gradio-dashboard.py - Book gallery
gradio-dashboard.py
Other components
- Book seeker
Connections 22
- Kaggle books → Metadata cleaning: downloads dataset
README.md - Metadata cleaning → Cleaned books: writes cleaned data
README.md - Cleaned books → ISBN descriptions: provides descriptions
README.md - ISBN descriptions → Tagged descriptions: writes ISBN text
README.md - Tagged descriptions → Text embeddings: embeds descriptions
README.md - Text embeddings → Vector index: indexes vectors
README.md - Cleaned books → Category classification: classifies books
README.md - Category classification → Categorized books: writes categories
README.md - Categorized books → Emotion scoring: scores descriptions
README.md - Emotion scoring → Emotion-scored books: writes emotion scores
README.md - Book seeker → Gradio dashboard: enters query
gradio-dashboard.py - Gradio dashboard → Recommendation handler: dispatches inputs
gradio-dashboard.py - Gradio dashboard → Emotion-scored books: loads book records
gradio-dashboard.py - Gradio dashboard → Tagged descriptions: loads descriptions
gradio-dashboard.py - Gradio dashboard → Text embeddings: configures model
gradio-dashboard.py - Gradio dashboard → Vector index: opens or builds index
gradio-dashboard.py - Recommendation handler → Vector index: searches similar books
gradio-dashboard.py - Vector index → Recommendation handler: returns matches
gradio-dashboard.py - Recommendation handler → Emotion-scored books: maps ISBNs and filters
gradio-dashboard.py - Recommendation handler → Gallery formatting: passes recommendations
gradio-dashboard.py - Gallery formatting → Book gallery: formats cover captions
gradio-dashboard.py - Book gallery → Book seeker: displays results
gradio-dashboard.py