{"id":26604029,"url":"https://github.com/adityapradhan202/grimoire-guide","last_synced_at":"2025-07-22T05:04:12.170Z","repository":{"id":278964943,"uuid":"937304590","full_name":"adityapradhan202/Grimoire-Guide","owner":"adityapradhan202","description":"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.","archived":false,"fork":false,"pushed_at":"2025-07-02T09:54:13.000Z","size":22598,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-02T10:48:02.019Z","etag":null,"topics":["book-recommendations","cosine-similarity","data-science","machine-learning","natural-language-processing","python","statistical-machine-learning","streamlit-application"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adityapradhan202.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-22T20:18:13.000Z","updated_at":"2025-07-02T09:54:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"42686d42-8f43-43e6-8f85-f92ebc03693a","html_url":"https://github.com/adityapradhan202/Grimoire-Guide","commit_stats":null,"previous_names":["adityapradhan202/grimoire-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/adityapradhan202/Grimoire-Guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityapradhan202%2FGrimoire-Guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityapradhan202%2FGrimoire-Guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityapradhan202%2FGrimoire-Guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityapradhan202%2FGrimoire-Guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adityapradhan202","download_url":"https://codeload.github.com/adityapradhan202/Grimoire-Guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adityapradhan202%2FGrimoire-Guide/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266430672,"owners_count":23927166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book-recommendations","cosine-similarity","data-science","machine-learning","natural-language-processing","python","statistical-machine-learning","streamlit-application"],"created_at":"2025-03-23T19:19:24.630Z","updated_at":"2025-07-22T05:04:12.162Z","avatar_url":"https://github.com/adityapradhan202.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grimoire-Guide\nGrimoire 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.\n\n## Guide for running this on local machine:\n\n**1. Clone the repository:**  \nUse the command given below in the git bash terminal:  \n```git clone https://github.com/adityapradhan202/Grimoire-Guide.git```\n\n**2. Install the dependencies:**  \nOpen a new terminal in the project folder and type this command:  \n```pip install -r requirements.txt```\n\n**3. Run the app:**  \nIn the terminal of the project folder type this command to run the app on local host:   \n```streamlit run app.py```\n\n## How it works:\n\nGrimoire-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.\n\n## Further improvements:\nThis 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.\n\n## App images:\n\n![img](https://github.com/adityapradhan202/Grimoire-Guide/blob/main/app_images/app_img1.png?raw=true)\n![img2](https://github.com/adityapradhan202/Grimoire-Guide/blob/main/app_images/app_img2.png?raw=true)\n\n## About contribution:\nIt 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. 😊\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityapradhan202%2Fgrimoire-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadityapradhan202%2Fgrimoire-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityapradhan202%2Fgrimoire-guide/lists"}