{"id":28962160,"url":"https://github.com/samuelschnurr/retail-radar","last_synced_at":"2026-04-11T02:01:59.759Z","repository":{"id":298185559,"uuid":"772695907","full_name":"samuelschnurr/retail-radar","owner":"samuelschnurr","description":"Retailradar is an AI-powered product advisory messenger that connects users with Chappie, an OpenAI assistant. Based on the information provided, Chappie recommends the most suitable products tailored to each user's needs.","archived":false,"fork":false,"pushed_at":"2025-06-09T21:19:49.000Z","size":7548,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-09T21:31:25.984Z","etag":null,"topics":["ai","antd","api","assistant","chatgpt","chatscope","csharp","javascript","landingpage","messenger","openai","react","rest","spa","styledcomponents","typescript"],"latest_commit_sha":null,"homepage":"https://schnurr.io","language":"TypeScript","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/samuelschnurr.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":"2024-03-15T17:48:32.000Z","updated_at":"2025-06-09T21:19:52.000Z","dependencies_parsed_at":"2025-06-09T21:42:22.920Z","dependency_job_id":null,"html_url":"https://github.com/samuelschnurr/retail-radar","commit_stats":null,"previous_names":["samuelschnurr/retail-radar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/samuelschnurr/retail-radar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelschnurr%2Fretail-radar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelschnurr%2Fretail-radar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelschnurr%2Fretail-radar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelschnurr%2Fretail-radar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samuelschnurr","download_url":"https://codeload.github.com/samuelschnurr/retail-radar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelschnurr%2Fretail-radar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261595629,"owners_count":23182240,"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":["ai","antd","api","assistant","chatgpt","chatscope","csharp","javascript","landingpage","messenger","openai","react","rest","spa","styledcomponents","typescript"],"created_at":"2025-06-24T03:01:10.578Z","updated_at":"2025-12-30T21:07:25.139Z","avatar_url":"https://github.com/samuelschnurr.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RetailRadar\n\nThis repository provides full access to the \"RetailRadar\" application - a full-stack single-page application (SPA) where users can interact with the AI chatbot \"Chappie.\" Chappie is an OpenAI-powered assistant that asks users about their preferences and product wishes, then recommends suitable products available on Amazon.\n\nAlthough the application is no longer officially maintained, it can still be set up and hosted independently using the code provided in this repository.\n\n## Build and Run\n\nBoth the frontend and backend of this application can be built and started without any additional configuration. The connection between the frontend and backend is already fully established out of the box. However, for the backend to function correctly as an AI-powered chatbot, two resources and configurations are required. These must be provided either in the `appsettings.Development.json` file or via [.NET User Secrets](https://learn.microsoft.com/en-us/aspnet/core/security/app-secrets?view=aspnetcore-9.0\u0026tabs=windows).\n\n**OpenAI Assistant**\n\nAn `Azure OpenAI Assistant` (Microsoft.CognitiveServices) must be set up using the [linked prompt](https://github.com/samuelschnurr/retail-radar/blob/main/Docs/Prompt.txt). The assistant uses the ongoing chat history and its configured prompt to provide product suggestions in a predefined format. You will need to store the following values in `appsettings.Development.json`:\n\n- OpenAi API Secret\n- AssistantId\n- BaseAddress\n\nThese credentials enable the backend to communicate with the assistant and receive structured product suggestions based on user input.\n\n**Google Search API**\n\nTo convert the product suggestions provided by the Assistant into actual Amazon links, the `Google Programmable Search Engine API` is used. The assistant returns structured product names, which are then searched via the API. The best-matching Amazon result is extracted and linked in place of the original product name.\n\nYou’ll need to set up a [Programmable Search Engine (Paid Element)](https://console.cloud.google.com/apis/library/programmablesearchelement.googleapis.com) which is described [here](https://developers.google.com/custom-search/docs/paid_element). \n\n You will need to store the following values in `appsettings.Development.json`:\n\n- Google API Secret\n- EngineId\n\n## Demonstration\n\nBased on the chat messages, the AI chatbot Chappie analyzes your preferences and provides personalized product recommendations.\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Image of the product landing screen which shows a 'Start now' button and information for the product.\" src=\"https://github.com/samuelschnurr/retail-radar/blob/main/Docs/Landingscreen-WithLayout.png\" style=\"width:80%\" /\u003e\n\n\u003cimg alt=\"Image of a the mobile and responsive view of the landingscreen. Beside there is another mobile screen which shows the easy to start mobile experience which offers the users three different predefined buttons to submit as first message to the chatbot.\" src=\"https://github.com/samuelschnurr/retail-radar/blob/main/Docs/Responsive-WithLayout.png\" style=\"width:80%\" /\u003e\n\n\u003cimg alt=\"Shows two images which contain a long conversation with the chatbot Chappie. It shows messages of the user and Chappie. In the end Chappie recommends 3 different products.\" src=\"https://github.com/samuelschnurr/retail-radar/blob/main/Docs/Recommendation-WithLayout.png\" style=\"width:80%\" /\u003e\n\n\u003c/p\u003e\n\n## License\n\nThis repository is under MIT license (see \u003ca href=\"https://github.com/samuelschnurr/retail-radar/blob/master/LICENSE\"\u003eLICENSE\u003c/a\u003e).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelschnurr%2Fretail-radar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamuelschnurr%2Fretail-radar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelschnurr%2Fretail-radar/lists"}