Skip to content

fury-05/BookRecomendApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Book Recommendation App

Languages and Farmeworks Used

HTML5 CSS3 Python Flask scikit-learn Replit Visual Studio Code Git GitHub

GitHub Stats

GitHub repo size GitHub GitHub release (latest by date) GitHub contributors GitHub issues GitHub pull requests GitHub last commit

The Book Recommendation App is an open-source project designed to provide personalized book recommendations to users based on their category, genre, and mood preferences. It uses a content-based filtering algorithm to enhance recommendation relevance.

Features

  • User-friendly web interface for inputting preferences.
  • Utilizes the Google Books API for book data.
  • Enhanced recommendations using content-based filtering.
  • Detailed README and instruction for contribution.

Language

  • Python 3.9

Getting Started

To run this project locally, follow these instructions:

  1. Clone this repository:
git clone https://github.com/fury-05/Book-Recommendation-App.git
  1. Change to the project directory:
cd Book-Recommendation-App
  1. Install the required packages:
pip install -r requirements.txt
  1. Set up the Google Books API key:

    • Obtain a Google Books API key and add it to your environment or create a Replit Secrets variable named "google_api_key".
  2. Set up the New York Times API key:

    • Obtain a New York Times API key and add it to your environment or create a Replit Secrets variable named "nyt_api_key".

Usage

  1. Run the application:
python main.py
  1. Access the app in your web browser at http://localhost:5000.

Contributing

We welcome contributions from the community to enhance and refine the Book Recommendation App. If you'd like to contribute, please follow these steps:

  1. Fork this repository to your GitHub account.

  2. Clone your forked repository:

git clone https://github.com/YourUsername/Book-Recommendation-App.git
  1. Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-name
  1. Make your changes and commit them:
git commit -m "Add your feature description"
  1. Push your changes to your GitHub repository:
git push origin feature/your-feature-name
  1. Create a pull request (PR) from your GitHub repository to the main repository.

  2. Await approval from the project maintainers to merge your PR.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Version

Version 1.1.0

Acknowledgments

Screen Shots

When You Run Application And Open Browser.

image

After Selecting Your Mood Settings.

image

Expanding The Trending Books Section.

image

Expanding Recomendation Section Results Based on Selections and Applying Algorithm.

image

Expanding Raw API Data View - For Developers For Trouble Shooting Or Demonstrating How We Fetch Data.

image

We appreciate your contributions to make the Book Recommendation App even better!