{"id":23631613,"url":"https://github.com/fredcodee/ai-driven-product-recommendation-engine","last_synced_at":"2026-04-17T10:31:21.039Z","repository":{"id":269714361,"uuid":"908246868","full_name":"fredcodee/AI-Driven-Product-Recommendation-Engine","owner":"fredcodee","description":"React- native app for recommendation engine using Python and machine learning algorithms","archived":false,"fork":false,"pushed_at":"2025-01-29T01:58:22.000Z","size":476,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-18T23:34:51.022Z","etag":null,"topics":["nodejs","react-native"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fredcodee.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-12-25T15:09:26.000Z","updated_at":"2025-01-29T01:59:01.000Z","dependencies_parsed_at":"2025-02-18T21:43:11.708Z","dependency_job_id":null,"html_url":"https://github.com/fredcodee/AI-Driven-Product-Recommendation-Engine","commit_stats":null,"previous_names":["fredcodee/ai-driven-product-recommendation-engine"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fredcodee/AI-Driven-Product-Recommendation-Engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fredcodee%2FAI-Driven-Product-Recommendation-Engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fredcodee%2FAI-Driven-Product-Recommendation-Engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fredcodee%2FAI-Driven-Product-Recommendation-Engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fredcodee%2FAI-Driven-Product-Recommendation-Engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fredcodee","download_url":"https://codeload.github.com/fredcodee/AI-Driven-Product-Recommendation-Engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fredcodee%2FAI-Driven-Product-Recommendation-Engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31925294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T10:19:20.377Z","status":"ssl_error","status_checked_at":"2026-04-17T10:19:18.682Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["nodejs","react-native"],"created_at":"2024-12-28T03:17:32.758Z","updated_at":"2026-04-17T10:31:21.020Z","avatar_url":"https://github.com/fredcodee.png","language":"TypeScript","readme":"# AI-Driven Product Recommendation Engine\nA React- native app for recommendation engine that delivers personalized product suggestions in real-time for an e-commerce platform.\nrecommendation system that can be integrated into an e-commerce platform\n\n### Stack:\n- AI/ML: Python ( Scikit-learn, TensorFlow/Keras).\n- Backend: Node.js with Express.js for APIs.\n- 3RD-PARTY-API: https://axesso.developer.azure-api.net/ for amazon api access\n- Frontend: React Native for a mobile app.\n\n# Documentations\n**Objective**\nCollect or simulate a dataset containing user interactions and product details.\n- Public Dataset: - Amazon Product Reviews Dataset from https://www.kaggle.com/datasets/saurav9786/amazon-product-reviews?resource=download\n\n**Overview**\nThe recommendation engine is designed to provide personalized product recommendations to users based on their preferences and behavior. It employs machine learning techniques to analyze user interactions, patterns, and product data to generate relevant suggestions.\n\nKey Components\n- Data Preprocessing\nCleans and organizes raw input data for training the model.\nFormats include user-item interactions such as product ratings,\n\n- Recommendation Model\nA collaborative filtering algorithm forms the basis of the recommendation engine.\nIt utilizes user-item interaction matrices to identify patterns and similarities between users and products.\n\n- Model Training\nThe recommendation model is trained using historical user data.\nKey techniques include:\nMatrix Factorization (e.g., Singular Value Decomposition - SVD).\n\n- Recommendation Retrieval\nAfter training, the model can predict products of interest for each user.\nRecommendations are sorted based on predicted relevance.\n\n\n\n# Api Endpoints\n### BUILD MODEL \nTrigger the process to build or train the recommendation model.\n\n**Endpoint** GET /model/build\n\n**Response**\n\n200 OK (When the model is successfully built)\n\n```json\n{\n  \"message\": \"Recommendation model built successfully.\"\n}\n```\n\n\n### GET USER RECOMMENDATION\nFetch personalized product recommendations for a specific user, including detailed product information from Amazon.\n\n**Endpoint** GET api/recommendations/:userId\n\n**Path Parameters**: userId (string): The ID of the user for whom recommendations are being fetched.\n\n**Response**\n```json\n{\n    \"userId\": \"{amazon_userId}\",\n    \"recommendations\": [\n        \"{productId}\",\n        \"{productId}\",\n        \"...\"\n    ],\n    \"productDetails\": {\n        \"id\": \"{product Id}\",\n        \"name\": \"Product Title 1\",\n        \"description\": \"Product description 1\", \n        \"image\": \"https://image-link-1.com\",\n        \"price\": 81.97, //example\n        \"rating\": \"4.2 out of 5 stars\", //example\n        \"link\": \"{Product Link}\" \n    },\n    {\n        \"id\": \"{product Id}\",\n        \"name\": \"Product Title 2\",\n        \"description\": \"Product description 2\", \n        \"image\": \"https://image-link-2.com\",\n        \"price\": 29.97, //example\n        \"rating\": \"4.2 out of 5 stars\", //example\n        \"link\": \"{Product Link}\" \n    }\n}\n```\n\n\n\n# Future Enhancements\n- Hybrid Recommendations: Combine collaborative filtering with content-based filtering for improved accuracy.\n- A/B Testing: Implement A/B testing to evaluate recommendation effectiveness.\n- User Feedback Integration: Use explicit feedback (e.g., likes, dislikes) to refine recommendations.\n- This documentation provides a simple guide to understand and utilize the recommendation engine effectively. Let me know if you'd like to include more technical details or workflows!\n\n\n# App view\n![alt text](https://github.com/fredcodee/AI-Driven-Product-Recommendation-Engine/blob/main/appviewImages/view1.jpg)\n![alt text](https://github.com/fredcodee/AI-Driven-Product-Recommendation-Engine/blob/main/appviewImages/view2.jpg)\n\n#App Video presentation\nhttps://photos.app.goo.gl/7Czh32yPqjbaFEZg6\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffredcodee%2Fai-driven-product-recommendation-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffredcodee%2Fai-driven-product-recommendation-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffredcodee%2Fai-driven-product-recommendation-engine/lists"}