Upload README.md

README.md

@@ -1,14 +1,44 @@
----
-title: Semantic Book Recommender
-emoji: 🔥
-colorFrom: yellow
-colorTo: blue
-sdk: gradio
-sdk_version: 5.49.0
-app_file: app.py
-pinned: false
-license: mit
-short_description: This a simple semantic book recommender created with gradio
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+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