https://github.com/adityapradhan202/grimoire-guide

Grimoire Guide is a book recommendation system which leverages statistical machine learning and NLP concepts to recommend the best books to the users. Just provide a plot or description, and it will do the rest of the job for you.
https://github.com/adityapradhan202/grimoire-guide

book-recommendations cosine-similarity data-science machine-learning natural-language-processing python statistical-machine-learning streamlit-application

Last synced: 11 months ago
JSON representation

Grimoire Guide is a book recommendation system which leverages statistical machine learning and NLP concepts to recommend the best books to the users. Just provide a plot or description, and it will do the rest of the job for you.

• Host: GitHub
• URL: https://github.com/adityapradhan202/grimoire-guide
• Owner: adityapradhan202
• License: mit
• Created: 2025-02-22T20:18:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-02T09:54:13.000Z (11 months ago)
• Last Synced: 2025-07-02T10:48:02.019Z (11 months ago)
• Topics: book-recommendations, cosine-similarity, data-science, machine-learning, natural-language-processing, python, statistical-machine-learning, streamlit-application
• Language: Jupyter Notebook
• Homepage:
• Size: 21.6 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Grimoire-Guide

Grimoire Guide is an AI powered book recommendation system which leverages statistical machine learning, data science and NLP concepts to recommend the best books to the users. Just provide a plot or description, and it will do the rest of the job for you.

## Guide for running this on local machine:

**1. Clone the repository:**  

Use the command given below in the git bash terminal:  

```git clone https://github.com/adityapradhan202/Grimoire-Guide.git```

**2. Install the dependencies:**  

Open a new terminal in the project folder and type this command:  

```pip install -r requirements.txt```

**3. Run the app:**  

In the terminal of the project folder type this command to run the app on local host:   

```streamlit run app.py```

## How it works:

Grimoire-Guide uses a simple concept of 'cosine similarity', which is available in `scikit-learn`. We can convert two separate texts into vectors or numbers and then we can use the concept of cosine similarity to see how similar the two texts are.

## Further improvements:

This is more like a practice project to understand and implement the concept of cosine similarity. Further, we can code neural networks on bigger dataset and create more robust ML application.

## App images:

![img](https://github.com/adityapradhan202/Grimoire-Guide/blob/main/app_images/app_img1.png?raw=true)

![img2](https://github.com/adityapradhan202/Grimoire-Guide/blob/main/app_images/app_img2.png?raw=true)

## About contribution:

It would be great if you could contribute to and improve 'Grimoire-Guide'. Please create a separate feature branch with your own code and submit a pull request. If your code adds value to the project, your pull request will be reviewed and accepted. 😊