NLproductsearch / README.md
ghostai1's picture
Updated status on August 28, 2025
e011070 verified

A newer version of the Gradio SDK is available: 5.44.0

Upgrade
metadata
title: NLproductsearch
emoji: πŸ”₯
colorFrom: green
colorTo: gray
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: NL product csv demo

πŸ›οΈ Salon Catalog Semantic Search

Hugging Face Space
[Gradio UI]
Model
License


πŸš€ Overview

Let salon staff or customers type any natural-language query (e.g.,
β€œsulfate-free shampoo under $15” or β€œhighest-end curling iron”) and instantly
see the top 5 matching products from a 50-item catalogβ€”no keyword matching,
pure semantic embeddings.

Why not use an external HF API?
Running the MiniLM model locally in the Space ensures zero API costs,
full data privacy, and lightning-fast CPU inference.


✨ Key Features

πŸ”‘ Feature πŸ” Why It Matters
🧠 Semantic Matching Understands intent & phrasing, not just literal keywords
⚑ CPU-only Inference Runs on free 2 vCPU / 16 GB RAM without GPUs
πŸ“Š Interactive Table View product ID, name, category, price, and similarity score
πŸ”§ Easy Extensibility Swap in your own products.csvβ€”no code changes required
☁️ Instant Deploy Commit three files; Spaces auto-builds & hosts your demo

πŸ—οΈ Architecture & Workflow

  1. Load Catalog
    Reads products.csv into a Pandas DataFrame.
  2. Embed Descriptions
    Uses all-MiniLM-L6-v2 to compute 384-d embeddings for each product description.
  3. User Query
    Encoded on the fly; cosine similarity ranks the catalog.
  4. UI Rendering
    Gradio displays a sortable DataFrame of top-K products and their scores.

πŸ› οΈ Local Development

git clone https://github.com/your-username/catalog-search.git
cd catalog-search
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python app.py

## Latest Update

- Improved MiniLM embeddings for better matching. πŸ”§ - May 29, 2025 πŸ“
- Enhanced product catalog search accuracy. 🧠 - August 28, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - August 27, 2025 πŸ“
- Improved Gradio table sorting functionality. ⚑ - August 25, 2025 πŸ“
- Optimized CPU inference speed. πŸ›οΈ - August 23, 2025 πŸ“
- Added support for custom CSV formats. 🧠 - August 22, 2025 πŸ“
- Enhanced product catalog search accuracy. - August 20, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - August 17, 2025 πŸ“
- Improved Gradio table sorting functionality. πŸ“Š - August 14, 2025 πŸ“
- Optimized CPU inference speed. πŸ”§ - August 13, 2025 πŸ“
- Added support for custom CSV formats. ⚑ - August 12, 2025 πŸ“
- Enhanced product catalog search accuracy. πŸ›οΈ - August 11, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - August 10, 2025 πŸ“
- Added support for custom CSV formats. - August 08, 2025 πŸ“
- Enhanced product catalog search accuracy. 🧠 - August 07, 2025 πŸ“
- Improved MiniLM embeddings for better matching. ⚑ - August 06, 2025 πŸ“
- Improved Gradio table sorting functionality. πŸ›οΈ - August 05, 2025 πŸ“
- Optimized CPU inference speed. - August 04, 2025 πŸ“
- Added support for custom CSV formats. - August 03, 2025 πŸ“
- Enhanced product catalog search accuracy. ⚑ - August 02, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - August 01, 2025 πŸ“
- Improved Gradio table sorting functionality. 🧠 - July 31, 2025 πŸ“
- Optimized CPU inference speed. πŸ“Š - July 30, 2025 πŸ“
- Added support for custom CSV formats. πŸ›οΈ - July 29, 2025 πŸ“
- Enhanced product catalog search accuracy. - July 28, 2025 πŸ“
- Improved MiniLM embeddings for better matching. πŸ”§ - July 27, 2025 πŸ“
- Improved Gradio table sorting functionality. - July 26, 2025 πŸ“
- Optimized CPU inference speed. ⚑ - July 25, 2025 πŸ“
- Added support for custom CSV formats. - July 24, 2025 πŸ“
- Enhanced product catalog search accuracy. πŸ›οΈ - July 23, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - July 22, 2025 πŸ“
- Improved Gradio table sorting functionality. πŸ”§ - July 21, 2025 πŸ“
- Optimized CPU inference speed. - July 19, 2025 πŸ“
- Added support for custom CSV formats. 🧠 - July 18, 2025 πŸ“
- Enhanced product catalog search accuracy. - July 17, 2025 πŸ“
- Improved MiniLM embeddings for better matching. πŸ“Š - July 16, 2025 πŸ“
- Improved Gradio table sorting functionality. 🧠 - July 15, 2025 πŸ“
- Optimized CPU inference speed. - July 11, 2025 πŸ“
- Added support for custom CSV formats. - July 10, 2025 πŸ“
- Enhanced product catalog search accuracy. - July 09, 2025 πŸ“
- Improved MiniLM embeddings for better matching. ⚑ - July 08, 2025 πŸ“
- Improved Gradio table sorting functionality. πŸ›οΈ - July 07, 2025 πŸ“
- Optimized CPU inference speed. πŸ“Š - July 06, 2025 πŸ“
- Added support for custom CSV formats. - July 05, 2025 πŸ“
- Enhanced product catalog search accuracy. πŸ”§ - July 04, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - July 03, 2025 πŸ“
- Improved Gradio table sorting functionality. - July 02, 2025 πŸ“
- Optimized CPU inference speed. - July 01, 2025 πŸ“
- Added support for custom CSV formats. 🧠 - June 30, 2025 πŸ“
- Enhanced product catalog search accuracy. - June 29, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - June 28, 2025 πŸ“
- Improved Gradio table sorting functionality. - June 27, 2025 πŸ“
- Optimized CPU inference speed. - June 26, 2025 πŸ“
- Added support for custom CSV formats. πŸ”§ - June 25, 2025 πŸ“
- Enhanced product catalog search accuracy. ⚑ - June 24, 2025 πŸ“
- Improved Gradio table sorting functionality. - June 22, 2025 πŸ“
- Optimized CPU inference speed. πŸ›οΈ - June 21, 2025 πŸ“
- Added support for custom CSV formats. - June 20, 2025 πŸ“
- Enhanced product catalog search accuracy. πŸ“Š - June 19, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - June 18, 2025 πŸ“
- Improved Gradio table sorting functionality. - June 17, 2025 πŸ“
- Optimized CPU inference speed. - June 16, 2025 πŸ“
- Added support for custom CSV formats. - June 15, 2025 πŸ“
- Enhanced product catalog search accuracy. - June 14, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - June 13, 2025 πŸ“
- Optimized CPU inference speed. 🧠 - June 11, 2025 πŸ“
- Added support for custom CSV formats. - June 10, 2025 πŸ“
- Enhanced product catalog search accuracy. - June 09, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - June 08, 2025 πŸ“
- Improved Gradio table sorting functionality. πŸ“Š - June 07, 2025 πŸ“
- Optimized CPU inference speed. - June 06, 2025 πŸ“
- Added support for custom CSV formats. - June 05, 2025 πŸ“
- Enhanced product catalog search accuracy. - June 04, 2025 πŸ“
- Improved MiniLM embeddings for better matching. - June 03, 2025 πŸ“
- Improved Gradio table sorting functionality. ⚑ - June 02, 2025 πŸ“
- Optimized CPU inference speed. - June 01, 2025 πŸ“
- Added support for custom CSV formats. - May 31, 2025 πŸ“
- Enhanced product catalog search accuracy. - May 30, 2025 πŸ“

**Website**: https://ghostainews.com/
**Discord**: https://discord.gg/BfA23aYz