README.md

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

• OpenAI: Get from OpenAI Platform

🛡️ 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 🏪