{"id":20655413,"url":"https://github.com/bhimrazy/magazine-recommender-system","last_synced_at":"2026-04-13T04:47:04.971Z","repository":{"id":161627687,"uuid":"631798714","full_name":"bhimrazy/magazine-recommender-system","owner":"bhimrazy","description":"This project implements a magazine recommender system using Amazon review data from 2018 . The system calculates similarity scores between magazines and recommends the most similar magazines to the user.","archived":false,"fork":false,"pushed_at":"2023-05-07T13:12:10.000Z","size":5021,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T22:12:09.204Z","etag":null,"topics":["fastapi","python","recommender-system","tailwindcss"],"latest_commit_sha":null,"homepage":"https://recsys-project-fuseai-production.up.railway.app","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/bhimrazy.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}},"created_at":"2023-04-24T04:45:50.000Z","updated_at":"2023-05-07T12:58:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"3d86ed4b-c3cf-482f-b9ea-1f6eb6d5b7c2","html_url":"https://github.com/bhimrazy/magazine-recommender-system","commit_stats":null,"previous_names":["bhimrazy/magazine-recommender-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bhimrazy/magazine-recommender-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhimrazy%2Fmagazine-recommender-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhimrazy%2Fmagazine-recommender-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhimrazy%2Fmagazine-recommender-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhimrazy%2Fmagazine-recommender-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bhimrazy","download_url":"https://codeload.github.com/bhimrazy/magazine-recommender-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhimrazy%2Fmagazine-recommender-system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265224161,"owners_count":23730345,"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","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":["fastapi","python","recommender-system","tailwindcss"],"created_at":"2024-11-16T18:10:54.828Z","updated_at":"2026-04-13T04:47:04.914Z","avatar_url":"https://github.com/bhimrazy.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Magazine Recommender System\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis project implements a magazine recommender system using [Amazon review data from 2018](https://nijianmo.github.io/amazon/) . The system calculates similarity scores between magazines and recommends the most similar magazines to the user.\n\n## Table of Contents\n\n- [Magazine Recommender System](#magazine-recommender-system)\n  - [Table of Contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Getting Started](#getting-started)\n    - [Prerequisites](#prerequisites)\n    - [Installation](#installation)\n    - [Usage](#usage)\n  - [Data Preprocessing](#data-preprocessing)\n  - [Recommendation Algorithm](#recommendation-algorithm)\n  - [Web Interface](#web-interface)\n  - [Future Work](#future-work)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [Authors](#authors)\n\n## Introduction\n\nThis project implements a magazine recommender system using Amazon review data from 2018. The system is designed to recommend magazines to users based on their interests and preferences. The recommender system calculates similarity scores between magazines using the cosine similarity metric and recommends the most similar magazines to the user.\n\nThe project also includes a web interface that allows users to enter their ratings for magazines and receive recommendations for similar magazines. The web interface was implemented using FastAPI and Tailwind CSS.\n\n## Getting Started\n\n### Prerequisites\n\nTo run this project, you need to have Python 3.7 or later installed on your system. You also need to have the following packages installed:\n\n- pandas\n- scikit-learn\n- numpy\n- fastapi\n- uvicorn\n- tailwind\n\n### Installation\n\n1. Clone the repository\n\n```sh\ngit clone https://github.com/bhimrazy/magazine-recommender-system.git\ncd magazine-recommender-system\ncd web\n```\n\n2. Install the required packages using pip\n\n```sh\npip install -r requirements.txt\n```\n\n### Usage\n\nTo run the web interface, use the following command:\n\n```sh\nuvicorn main:app --reload\n```\n\nThe web interface should now be accessible in your web browser at `http://localhost:8000/`.\n\n## Data Preprocessing\n\nThe Amazon review data was preprocessed as follows:\n\n1. Filtered the data to only include reviews for magazines.\n2. Removed duplicate reviews.\n3. Filtering Magazines and users\n  - Selecting users who have rated at least 5 magazines\n  - Selecting Magazines which have at least 10 reviews/ratings.\n  \n![image](https://user-images.githubusercontent.com/46085301/236679234-3e9c8a44-a9df-4132-954e-7edb17a26197.png)\n![image](https://user-images.githubusercontent.com/46085301/236679305-269a2866-90e1-40e9-9079-2efd0f03da3c.png)\n![image](https://user-images.githubusercontent.com/46085301/236679318-ab29951c-7349-4fe6-9441-f803da7b843a.png)\n\n## Recommendation Algorithm\n\nThe recommender system uses the cosine similarity metric to calculate the similarity scores between magazines. The most similar magazines are recommended to the user based on their ratings of other magazines.\n\n## Web Interface\n\nThe web interface was implemented using FastAPI and Tailwind CSS. The user can enter their ratings for magazines and receive recommendations for similar magazines. The recommendations are updated dynamically as the user enters their ratings.\n![image](https://user-images.githubusercontent.com/46085301/236679105-5f207f9a-1a02-4e6c-9172-a9e857a57571.png)\n\n## Future Work\n\nSome potential areas for future work on this project include:\n\n- Evaluating the performance of the recommender system using metrics such as precision, recall, and F1 score.\n- Implementing a collaborative filtering algorithm to improve the accuracy of the recommendations.\n- Scaling the system to handle larger datasets using techniques such as MapReduce.\n\n## Contributing\n\nContributions to this project are welcome. To contribute, please follow these steps:\n\n1. Fork this repository.\n2. Create a new branch for your changes.\n3. Make your changes and commit them.\n4. Push your changes to your fork.\n\n## License\n\nThis project is licensed under the [MIT License](https://opensource.org/licenses/MIT) - see the [LICENSE](LICENSE) file for details.\n\n## Authors\n\nContributions to this project were made by:\n\n- [Bhimraj Yadav](https://github.com/bhimrazy)\n- [Nishan Rai](https://github.com/Nishan8912)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhimrazy%2Fmagazine-recommender-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhimrazy%2Fmagazine-recommender-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhimrazy%2Fmagazine-recommender-system/lists"}