ShelfPhotoAnalyzer / README.md
Marek4321's picture
Update README.md
5f43d78 verified

A newer version of the Streamlit SDK is available: 1.53.1

Upgrade
metadata
title: Shelf Photo Analyzer
emoji: πŸͺ
colorFrom: red
colorTo: yellow
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false
license: apache-2.0

πŸͺ Shelf Photo Analyzer

Professional AI-powered tool for merchandisers and retail managers to analyze product displays on store shelves. Get instant analysis with actionable recommendations to improve product placement and boost sales.

✨ Features

  • πŸ“Έ Photo Upload - Support for JPG, PNG, WebP formats up to 10MB
  • πŸ” Product Detection - AI-powered product recognition and analysis
  • πŸ€– Smart Analysis - Uses GPT-4 Vision API for accurate shelf assessment
  • πŸ“Š Compliance Scoring - 1-10 score for product placement effectiveness
  • πŸ’‘ Actionable Recommendations - Specific suggestions with impact estimates
  • πŸ“± Mobile Friendly - Responsive design for field use
  • πŸ“ˆ Impact Forecasting - Estimated sales improvement from changes

πŸš€ Quick Start

  1. Enter your OpenAI API key
  2. Upload a clear photo of the store shelf
  3. Enter the product name you want to analyze
  4. Select analysis depth (Basic/Detailed/Expert)
  5. Click "πŸš€ Analyze Photo" and wait 15-30 seconds
  6. Review results and follow the recommendations

Analysis Results

The AI provides comprehensive analysis including:

  • βœ… Product Detection - Whether product is visible on shelf
  • πŸ“¦ Facing Count - Number of visible product units
  • πŸ“ Shelf Position - Top/middle/bottom placement
  • πŸ’° Price Visibility - Whether pricing is clearly shown
  • 🧹 Product Condition - Cleanliness and damage assessment
  • πŸ† Overall Score - 1-10 rating for placement effectiveness
  • 🎯 Confidence Level - AI certainty in the analysis

Recommendations Engine

Get prioritized action items with:

  • 🚨 Priority Levels - Critical, high, medium, low priorities
  • ⏱️ Time Estimates - How long each fix will take
  • πŸ“ˆ Impact Predictions - Expected sales/visibility improvements
  • πŸ”§ Difficulty Rating - How easy each recommendation is to implement

πŸ”‘ API Key Required

πŸ›‘οΈ Privacy

  • API keys never stored permanently
  • Images processed temporarily only
  • No data retention

πŸ“„ License

Licensed under Apache License 2.0

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

Marek Staniszewski
Heuristica
🌐 www.heuristica.pl
πŸ“§ staniszewski@heuristica.pl

For questions, suggestions, or support, please contact the author.


Shelf Photo Analyzer - Professional shelf analysis tool πŸͺ