---
title: BookMind
emoji: 📚
colorFrom: blue
colorTo: purple
sdk: docker
app_file: app.py
pinned: true
license: mit
---

# 📚 BookMind - AI-Powered Book Recommendation System

Welcome to **BookMind**, an intelligent book recommendation engine powered by machine learning!

## ✨ Features

### 📖 Book Discovery
- **Search Functionality**: Find books by title, author, or ISBN
- **Trending Books**: Discover popular and highly-rated books
- **Book Details**: View comprehensive information about each book
- **User Ratings**: 5-star rating system for personalized recommendations

### 🤖 Smart Recommendations
- **Collaborative Filtering**: Recommendations based on user ratings patterns
- **Content-Based**: Similar books based on genres and book features
- **Hybrid Approach**: Combined intelligence for better results

### 💝 Personalization
- **Favorites Management**: Save your favorite books
- **Rating History**: Track all your book ratings
- **Persistent Storage**: Your data is saved locally in your browser
- **Recommendation Feed**: Get personalized suggestions based on your ratings

### 🎨 User Experience
- **Beautiful UI**: Ocean blue theme with smooth animations
- **Responsive Design**: Works perfectly on desktop, tablet, and mobile
- **Fast Performance**: Optimized for quick load times
- **Professional Design**: Modern, clean, and intuitive interface

## 🛠️ Technology Stack

### Backend
- **FastAPI**: Modern Python web framework
- **scikit-learn**: Machine learning algorithms
- **Pandas**: Data processing and analysis
- **Python 3.11**: Latest stable Python version

### Frontend
- **React 19**: Modern UI library with Hooks
- **Vite**: Lightning-fast build tool
- **Tailwind CSS**: Utility-first CSS framework
- **JavaScript ES6+**: Modern JavaScript

### Data
- **Book-Crossing Dataset**: 271K books, 1.1M users, 8M ratings
- **In-Memory Processing**: Fast data loading and recommendations
- **Local Storage**: Browser-based data persistence

### Deployment
- **Docker**: Containerized application
- **Hugging Face Spaces**: Free cloud hosting
- **uvicorn**: ASGI server for FastAPI

## 🚀 Getting Started

Visit the live application at:
[BookMind on Hugging Face Spaces](https://huggingface.co/spaces/vishalharkal/BookMind)

## 🎯 Features

1. **Search Books** - Find books by title, author, or keywords
2. **Rate Books** - Give 5-star ratings to rate your experience
3. **Save Favorites** - Keep track of books you love
4. **Get Recommendations** - AI-powered personalized suggestions
5. **Share** - Share books with friends and family

## 🤖 Recommendation Models

- **Collaborative Filtering**: Based on user rating patterns
- **Content-Based**: Based on book features and metadata
- **Hybrid**: Combines both approaches for best results

## 💾 Data

All data is stored locally in your browser. Your preferences stay with you:
- Favorites list
- Ratings history
- Search history

## 📊 Dataset

Using the Book-Crossing Dataset:
- 271,360 books
- 278,858 users
- 8,549,592 ratings

## 📄 License

MIT License - See LICENSE file for details

## 🙏 Credits

- Dataset: Book-Crossing Dataset
- Hosting: Hugging Face Spaces
- Built with: FastAPI, React, scikit-learn

---

**Enjoy discovering your next favorite book with BookMind!** 📚✨