Spaces:
Running
Running
| 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 | |
| [](https://huggingface.co/spaces/your-username/catalog-search) | |
| [] | |
| [](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) | |
| [](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 | |
| ```bash | |
| 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 📝 | |
| - Optimized CPU inference speed. 📊 - September 01, 2025 📝 | |
| - Added support for custom CSV formats. - August 30, 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 |