README.md

---
title: Book Semantic Search
emoji: 📚
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.47.2
app_file: app.py
pinned: false
license: mit
---

# Book Semantic Search 📚

A semantic search application for discovering books based on emotional tone and themes.

## Features

- 🔍 **Semantic Search**: Find books using natural language queries
- 😊 **Emotion-based Filtering**: Filter by emotional tones (Suspenseful, Sad, Romantic, etc.)
- 📑 **Category Filtering**: Browse by book categories
- 🎯 **Smart Recommendations**: Get personalized book recommendations based on content similarity

## How to Use

1. **Enter Your Query**: Describe what kind of book you're looking for
2. **Select Tone** (Optional): Choose an emotional tone to narrow results
3. **Select Category** (Optional): Filter by book category
4. **Get Recommendations**: Click submit to see your personalized book recommendations

## Technology Stack

- **Frontend**: Gradio
- **Backend**: Python
- **Search**: Semantic similarity using embeddings
- **Data**: Curated book dataset with emotional tone annotations

## Local Development
```bash
# Install dependencies
pip install -r requirements.txt

# Run the app
python app.py