Skip to content

Noopur17/retail-ai-intelligence-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

34 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›’ Retail AI Intelligence Platform

An enterprise-inspired AI platform for intelligent commerce systems, semantic retail search, recommendation workflows, and Retrieval-Augmented Generation (RAG).

Designed to demonstrate how modern AI systems can power large-scale retail ecosystems across grocery, electronics, fashion, home, and general merchandise commerce platforms.

Python FastAPI React OpenAI ChromaDB Docker Retail AI


πŸš€ Vision

Modern commerce platforms require more than isolated machine learning models.

They require intelligent systems capable of:

  • Understanding customer behavior
  • Delivering personalized recommendations
  • Generating AI-powered product content
  • Retrieving retail knowledge semantically
  • Assisting merchandising workflows
  • Powering intelligent commerce experiences

This project demonstrates how multiple AI services can work together inside a scalable Retail AI platform architecture.


✨ Platform Highlights

  • 🧠 Retail AI RAG Assistant
  • πŸ€– Recommendation Intelligence Engine
  • ✍️ AI-Powered Content Generation
  • πŸ”Ž Semantic Commerce Search
  • πŸ—‚οΈ ChromaDB Vector Database Integration
  • ⚑ OpenAI Embeddings & Retrieval
  • 🐳 Dockerized Microservices Platform
  • πŸ›οΈ Retail Knowledge Base Workflows
  • πŸ“Š Enterprise Retail Intelligence Architecture
  • πŸš€ React + FastAPI Production-Inspired Stack

πŸ“š Documentation

Document Description
Platform Architecture High-level Retail AI platform architecture
RAG Architecture Semantic retrieval and vector search workflows
Service Architecture FastAPI microservice interactions
Dataset Documentation Retail AI dataset design and schema
Local Development Local setup and development workflow
Roadmap Future platform direction
Research Alignment AI engineering and research areas

πŸ—οΈ Platform Architecture

Visual Architecture Diagram

flowchart TB
    UI[React + Vite Frontend Dashboard]

    UI --> REC[Recommendation Service<br/>FastAPI :8001]
    UI --> CONTENT[Content Intelligence Service<br/>FastAPI :8002]
    UI --> RAG[Retail AI RAG Assistant<br/>FastAPI :8003]

    REC --> PRODUCT[(Retail Product Catalog Dataset)]
    CONTENT --> OPENAI[OpenAI API]
    RAG --> CSV[(Retail AI Knowledge Base CSV)]
    RAG --> CHROMA[(ChromaDB Vector Store)]
    RAG --> OPENAI

    CSV --> INGEST[CSV Ingestion Pipeline]
    INGEST --> CHUNK[Chunking]
    CHUNK --> EMBED[OpenAI Embeddings]
    EMBED --> CHROMA
    CHROMA --> RETRIEVE[Semantic Retrieval]
    RETRIEVE --> ANSWER[AI Retail Answer Generation]
    ANSWER --> UI

    subgraph Services[FastAPI Microservices]
        REC
        CONTENT
        RAG
    end

    subgraph DataLayer[AI and Data Layer]
        OPENAI
        CHROMA
        PRODUCT
        CSV
    end
Loading
Retail AI Intelligence Platform
β”‚
β”œβ”€β”€ Frontend (React + Vite)
β”‚
β”œβ”€β”€ Recommendation Intelligence Service
β”‚   β”œβ”€β”€ Product similarity search
β”‚   β”œβ”€β”€ Recommendation scoring
β”‚   β”œβ”€β”€ Category-aware discovery
β”‚   └── Retail recommendation workflows
β”‚
β”œβ”€β”€ Content Intelligence Service
β”‚   β”œβ”€β”€ OpenAI-powered product content
β”‚   β”œβ”€β”€ SEO metadata generation
β”‚   β”œβ”€β”€ Product merchandising workflows
β”‚   └── Retail content intelligence
β”‚
β”œβ”€β”€ Retail AI RAG Assistant Service
β”‚   β”œβ”€β”€ Retail knowledge ingestion
β”‚   β”œβ”€β”€ OpenAI embeddings
β”‚   β”œβ”€β”€ ChromaDB vector storage
β”‚   β”œβ”€β”€ Semantic retrieval
β”‚   β”œβ”€β”€ AI-powered retail Q&A
β”‚   └── Commerce intelligence workflows
β”‚
β”œβ”€β”€ Customer Analytics Service (Planned)
β”‚
└── Log Intelligence Service (Planned)

🧠 Retail AI RAG Workflow

Retail Knowledge Base
        ↓
Document Ingestion
        ↓
Chunking Pipeline
        ↓
OpenAI Embeddings
        ↓
ChromaDB Vector Store
        ↓
Semantic Retrieval
        ↓
Context Injection
        ↓
LLM Response Generation
        ↓
Retail AI Assistant

πŸ”Œ Platform Services

Service Description Port
Frontend Dashboard Enterprise retail AI interface 5173
Recommendation Service Recommendation intelligence workflows 8001
Content Intelligence Service AI-powered product content generation 8002
Retail AI RAG Assistant Semantic retail retrieval & AI Q&A 8003

🧩 Core AI Services

πŸ›’ Recommendation Intelligence Service

AI-powered retail recommendation workflows for product discovery and similarity search.

Features

  • Product similarity scoring
  • Category-aware recommendations
  • Semantic recommendation workflows
  • Retail product discovery
  • Recommendation ranking engine

✍️ Content Intelligence Service

Generative AI workflows for retail product content and merchandising systems.

Features

  • AI-generated product titles
  • Product descriptions
  • SEO metadata generation
  • Bullet point generation
  • Merchandising content workflows
  • OpenAI-powered content systems

🧠 Retail AI RAG Assistant Service

A Retrieval-Augmented Generation (RAG) service designed for intelligent commerce retrieval workflows.

Features

  • Retail knowledge ingestion
  • OpenAI embeddings
  • ChromaDB vector search
  • Semantic retrieval
  • AI-powered retail Q&A
  • Retail merchandising intelligence
  • Commerce knowledge workflows
  • RAG-ready retrieval pipelines

πŸ“Š Customer Analytics Service (Planned)

Future customer intelligence workflows.

Planned Features

  • Customer segmentation
  • Behavioral intelligence
  • Engagement analysis
  • AI-powered customer insights
  • Retail analytics workflows

βš™οΈ Log Intelligence Service (Planned)

Operational AI workflows for monitoring and intelligence systems.

Planned Features

  • AI-assisted log analysis
  • Operational intelligence
  • Intelligent monitoring workflows
  • Production issue insights

πŸ€– AI Capabilities

This platform explores practical AI applications for modern commerce systems.

Supported Workflows

  • Retrieval-Augmented Generation (RAG)
  • Recommendation systems
  • Semantic vector search
  • AI-powered content generation
  • Retail intelligence workflows
  • Product discovery systems
  • Semantic commerce retrieval
  • AI merchandising assistants
  • OpenAI embedding pipelines

πŸ“Š Retail AI Knowledge Base Dataset

This platform is connected with the Kaggle dataset:

🧠 Retail AI Intelligence Knowledge Base

A large-scale AI-ready dataset designed for:

  • Semantic retrieval
  • Recommendation systems
  • RAG workflows
  • Retail AI assistants
  • Commerce intelligence systems

Dataset Features

  • 100K+ retail intelligence records
  • Multi-category retail coverage
  • AI use case mappings
  • Semantic retrieval tags
  • Merchandising strategies
  • Customer segment intelligence

πŸ““ Premium Kaggle Notebook

The project also includes a premium Kaggle notebook focused on:

  • RAG workflows
  • Semantic retrieval
  • Retail AI intelligence
  • Recommendation analysis
  • Commerce AI insights
  • AI-ready dataset engineering

🐳 Dockerized Architecture

Run the entire platform locally using Docker Compose.

Start Platform

docker compose up --build

Service URLs

Service URL
Frontend Dashboard http://localhost:5173
Recommendation API http://localhost:8001/docs
Content Intelligence API http://localhost:8002/docs
Retail AI RAG API http://localhost:8003/docs

🐳 Docker Hub Images

Frontend

https://hub.docker.com/r/noopur17/retail-ai-frontend

Recommendation Service

https://hub.docker.com/r/noopur17/retail-recommendation-service

Content Intelligence Service

https://hub.docker.com/r/noopur17/retail-content-intelligence-service

πŸ–ΌοΈ Demo Screenshots

πŸ›’ Retail AI Dashboard

Dashboard


πŸ€– Recommendation Intelligence

Recommendations


✍️ Content Intelligence

Content AI


🧠 Retail AI RAG Assistant

RAG Assistant


βš™οΈ FastAPI Swagger APIs

Swagger


πŸ› οΈ Tech Stack

Frontend

  • React
  • Vite
  • JavaScript

Backend

  • FastAPI
  • Python
  • REST APIs

AI / ML

  • OpenAI
  • ChromaDB
  • Scikit-learn
  • Pandas
  • Vector Embeddings

Infrastructure

  • Docker
  • Docker Compose
  • Docker Hub

πŸ“‚ Project Structure

retail-ai-intelligence-platform/
β”‚
β”œβ”€β”€ docs/
β”‚   └── screenshots/
β”‚
β”œβ”€β”€ frontend/
β”‚
β”œβ”€β”€ services/
β”‚   β”œβ”€β”€ recommendation-service/
β”‚   β”œβ”€β”€ content-intelligence-service/
β”‚   β”œβ”€β”€ rag-assistant-service/
β”‚   β”œβ”€β”€ customer-analytics-service/
β”‚   └── log-intelligence-service/
β”‚
β”œβ”€β”€ datasets/
β”‚
β”œβ”€β”€ notebooks/
β”‚
└── docker-compose.yml

πŸ”Œ API Documentation

Recommendation Service

http://localhost:8001/docs

Content Intelligence Service

http://localhost:8002/docs

Retail AI RAG Assistant Service

http://localhost:8003/docs

πŸ§ͺ Local Development

Recommendation Service

cd services/recommendation-service
python -m uvicorn app.main:app --reload --port 8001

Content Intelligence Service

cd services/content-intelligence-service
python -m uvicorn app.main:app --reload --port 8002

Retail AI RAG Assistant Service

cd services/rag-assistant-service

python3 -m venv venv
source venv/bin/activate

python -m pip install -r requirements.txt

export OPENAI_API_KEY="your_api_key_here"

python -m uvicorn app.main:app --reload --port 8003

Frontend

cd frontend/frontend

npm install
npm run dev

πŸ”¬ Research & Engineering Areas

This project explores practical applications of:

  • Recommendation systems
  • Retrieval-Augmented Generation (RAG)
  • Semantic search systems
  • Retail intelligence workflows
  • Commerce AI systems
  • Generative AI applications
  • Intelligent retrieval pipelines
  • Enterprise AI platform engineering

πŸ›£οΈ Platform Roadmap

Completed

  • Recommendation Intelligence API
  • Content Intelligence Service
  • OpenAI Integration
  • Retail AI RAG Assistant
  • ChromaDB Vector Search
  • Dockerized Platform
  • Enterprise-style React Dashboard
  • Kaggle Retail AI Dataset
  • Premium Kaggle Notebook

Planned

  • Frontend RAG Chat Integration
  • Customer Analytics Service
  • Customer Review Ingestion
  • Retail Analytics Dashboard
  • Conversation Memory
  • AI Shopping Assistant
  • Recommendation Feedback Loop
  • End-to-End Retail AI Simulation

πŸ‘©β€πŸ’» Author

Noopur Bhatt

AI & Full-Stack Engineer focused on:

  • Retail AI Systems
  • Retrieval-Augmented Generation (RAG)
  • Recommendation Workflows
  • Generative AI Applications
  • Intelligent Commerce Platforms
  • Semantic Retrieval Systems
  • Scalable AI Services

⭐ Future Vision

The long-term vision of this project is to evolve into a production-inspired Retail AI ecosystem demonstrating how:

  • recommendation systems,
  • generative AI,
  • semantic retrieval,
  • vector search,
  • intelligent merchandising,
  • and commerce AI workflows

can work together inside modern enterprise retail platforms.

About

A modular AI platform for Enterprise-inspired Retail AI platform with RAG, semantic search, recommendation systems, OpenAI workflows, and vector retrieval architecture.tail intelligence, combining recommendation systems, fraud detection, customer analytics, and operational intelligence into one production-inspired architecture.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors