noopur17/retail-recommendation-service repository overview

⁠🤖 Retail Recommendation Service

A FastAPI-based product recommendation engine for retail intelligence platforms.

⁠🚀 Overview

This service generates product recommendations using similarity-based ranking and category-aware filtering.

It simulates how modern retail systems power product discovery, personalization, and search optimization at scale.

⁠🧠 Key Features

• Content-based recommendation engine
• Similarity scoring and ranking
• Category and sub-category filtering
• Product catalog API
• Swagger API documentation
• Dockerized microservice

⁠⚙️ Run Container

docker run -p 8001:8000 noopur17/retail-recommendation-service:latest

Open Swagger:

http://localhost:8001/docs

⁠🔌 API Example

GET /recommendations/{product_id}?top_k=5

⁠📊 Output

Returns:

• Source product
• Ranked similar products
• Similarity scores
• Retail metadata (category, price, rating, etc.)

⁠🧩 Platform Context

Part of:

Retail AI Intelligence Platform

Used alongside:

• retail-ai-frontend
• retail-content-intelligence-service

⁠📌 Use Case

Designed for:

• Product discovery
• Personalization workflows
• Retail recommendation systems
• AI-powered merchandising

Supports multi-category retail environments such as:

• Electronics
• Grocery
• Fashion
• Home goods