README.md

---
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](https://platform.openai.com/api-keys)

## 🛡️ 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](http://www.heuristica.pl)  
📧 staniszewski@heuristica.pl

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

---

**Shelf Photo Analyzer** - Professional shelf analysis tool 🏪