Skip to content

aadeity/a-book-a-month

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Book A Month 📚✨

Python Flask Django ML Model License

🚀 Overview

A Book A Month is an intelligent book recommendation system that suggests books based on users' reading preferences. Users can select their favorite books,from a list of books option(options can also be refreshed) and the system will provide a primary book recommendation with an option to refresh and see upto 10 more recommendations.

✨ Features

  • 📖 Personalized book recommendations based on user selection
  • 🎭 Multiple genres covered: rom-com, dark romance, fantasy, and more
  • 🔄 Refresh button to see alternative recommendations

📂 Project Structure

📦 a-book-a-month
 ┣ 📂 dataset/          # Book dataset
 ┣ 📂 models/           # Trained ML models
 ┣ 📂 notebooks/        # Jupyter notebooks for ML development
 ┣ 📂 static/           # CSS files
 ┣ 📂 templates/        # HTML templates for UI
 ┣ 📜 app.py            # Main backend script (Flask/Django)
 ┣ 📜 requirements.txt  # Dependencies
 ┣ 📜 README.md         # Project documentation
 ┣ 📜 .gitignore        # Ignore unnecessary files


Demo

image

image

image

image

image

image

image

image

## 🛠️ Installation & Usage

### Prerequisites

- Python 3.10+
- Flask or Django (depending on your backend choice)
- Virtual environment (optional but recommended)

### 🔧 Setup & Run

```bash
# Clone the repository
git clone https://github.com/your-username/a-book-a-month.git
cd a-book-a-month

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python app.py

Open your browser and navigate to: http://127.0.0.1:5000


📜 License

This project is open-source and available under the MIT License.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages