Book Recommendation App

Languages and Farmeworks Used

GitHub Stats

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

2. Change to the project directory:

cd Book-Recommendation-App

3. Install the required packages:

pip install -r requirements.txt

4. 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".

5. 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

6. Run the application:

python main.py

7. 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

3. Create a new branch for your feature or bug fix:

git checkout -b feature/your-feature-name

4. Make your changes and commit them:

git commit -m "Add your feature description"

5. Push your changes to your GitHub repository:

git push origin feature/your-feature-name

6. Create a pull request (PR) from your GitHub repository to the main repository.

7. 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.

After Selecting Your Mood Settings.

Expanding The Trending Books Section.

Expanding Recomendation Section Results Based on Selections and Applying Algorithm.

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

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

---