162 lines
4.4 KiB
Markdown
162 lines
4.4 KiB
Markdown
# 🎬 PunimTag Complete Demo Guide
|
|
|
|
## 🎯 Quick Client Demo (10 minutes)
|
|
|
|
**Perfect for:** Client presentations, showcasing enhanced face recognition features
|
|
|
|
---
|
|
|
|
## 🚀 Setup (2 minutes)
|
|
|
|
### 1. Prerequisites
|
|
```bash
|
|
cd /home/beast/Code/punimtag
|
|
source venv/bin/activate # Always activate first!
|
|
sudo apt install feh # Image viewer (one-time setup)
|
|
```
|
|
|
|
### 2. Prepare Demo
|
|
```bash
|
|
# Clean start
|
|
rm -f demo.db
|
|
|
|
# Check demo photos (should have 6+ photos with faces)
|
|
find demo_photos/ -name "*.jpg" -o -name "*.png" | wc -l
|
|
```
|
|
|
|
---
|
|
|
|
## 🎭 Client Demo Script (8 minutes)
|
|
|
|
### **Opening (30 seconds)**
|
|
*"I'll show you PunimTag - an enhanced face recognition tool that runs entirely on your local machine. It features visual face identification and intelligent cross-photo matching."*
|
|
|
|
### **Step 1: Scan & Process (2 minutes)**
|
|
```bash
|
|
# Scan photos
|
|
python3 photo_tagger.py scan demo_photos --recursive --db demo.db -v
|
|
|
|
# Process for faces
|
|
python3 photo_tagger.py process --db demo.db -v
|
|
|
|
# Show results
|
|
python3 photo_tagger.py stats --db demo.db
|
|
```
|
|
|
|
**Say:** *"Perfect! It found X photos and detected Y faces automatically."*
|
|
|
|
### **Step 2: Visual Face Identification (3 minutes)**
|
|
```bash
|
|
python3 photo_tagger.py identify --show-faces --batch 3 --db demo.db
|
|
```
|
|
|
|
**Key points to mention:**s
|
|
- *"Notice how it shows individual face crops - no guessing!"*
|
|
- *"Each face opens automatically in the image viewer"*
|
|
- *"You see exactly which person you're identifying"*
|
|
|
|
### **Step 3: Smart Auto-Matching (3 minutes)**
|
|
```bash
|
|
python3 photo_tagger.py auto-match --show-faces --db demo.db
|
|
```
|
|
|
|
**Key points to mention:**
|
|
- *"Watch how it finds the same people across different photos"*
|
|
- *"Side-by-side comparison with confidence scoring"*
|
|
- *"Only suggests logical cross-photo matches"*
|
|
- *"Color-coded confidence: Green=High, Yellow=Medium, Red=Low"*
|
|
|
|
### **Step 4: Search & Results (1 minute)**
|
|
```bash
|
|
# Search for identified person
|
|
python3 photo_tagger.py search "Alice" --db demo.db
|
|
|
|
# Final statistics
|
|
python3 photo_tagger.py stats --db demo.db
|
|
```
|
|
|
|
**Say:** *"Now you can instantly find all photos containing any person."*
|
|
|
|
---
|
|
|
|
## 🎯 Key Demo Points for Clients
|
|
|
|
✅ **Privacy-First**: Everything runs locally, no cloud services
|
|
✅ **Visual Interface**: See actual faces, not coordinates
|
|
✅ **Intelligent Matching**: Cross-photo recognition with confidence scores
|
|
✅ **Professional Quality**: Color-coded confidence, automatic cleanup
|
|
✅ **Easy to Use**: Simple commands, clear visual feedback
|
|
✅ **Fast & Efficient**: Batch processing, smart suggestions
|
|
|
|
---
|
|
|
|
## 🔧 Advanced Features (Optional)
|
|
|
|
### Confidence Control
|
|
```bash
|
|
# Strict matching (high confidence only)
|
|
python3 photo_tagger.py auto-match --tolerance 0.3 --show-faces --db demo.db
|
|
|
|
# Automatic high-confidence identification
|
|
python3 photo_tagger.py auto-match --auto --show-faces --db demo.db
|
|
```
|
|
|
|
### Twins Detection
|
|
```bash
|
|
# Include same-photo matching (for twins)
|
|
python3 photo_tagger.py auto-match --include-twins --show-faces --db demo.db
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Confidence Guide
|
|
|
|
| Level | Color | Description | Recommendation |
|
|
|-------|-------|-------------|----------------|
|
|
| 80%+ | 🟢 | Very High - Almost Certain | Accept confidently |
|
|
| 70%+ | 🟡 | High - Likely Match | Probably correct |
|
|
| 60%+ | 🟠 | Medium - Possible | Review carefully |
|
|
| 50%+ | 🔴 | Low - Questionable | Likely incorrect |
|
|
| <50% | ⚫ | Very Low - Unlikely | Filtered out |
|
|
|
|
---
|
|
|
|
## 🚨 Demo Troubleshooting
|
|
|
|
**If no faces display:**
|
|
- Check feh installation: `sudo apt install feh`
|
|
- Manually open: `feh /tmp/face_*_crop.jpg`
|
|
|
|
**If no auto-matches:**
|
|
- Ensure same people appear in multiple photos
|
|
- Lower tolerance: `--tolerance 0.7`
|
|
|
|
**If confidence seems low:**
|
|
- 60-70% is normal for different lighting/angles
|
|
- 80%+ indicates excellent matches
|
|
|
|
---
|
|
|
|
## 🎪 Complete Demo Commands
|
|
|
|
```bash
|
|
# Full demo workflow
|
|
source venv/bin/activate
|
|
rm -f demo.db
|
|
python3 photo_tagger.py scan demo_photos --recursive --db demo.db -v
|
|
python3 photo_tagger.py process --db demo.db -v
|
|
python3 photo_tagger.py stats --db demo.db
|
|
python3 photo_tagger.py identify --show-faces --batch 3 --db demo.db
|
|
python3 photo_tagger.py auto-match --show-faces --db demo.db
|
|
python3 photo_tagger.py search "Alice" --db demo.db
|
|
python3 photo_tagger.py stats --db demo.db
|
|
```
|
|
|
|
**Or use the interactive script:**
|
|
```bash
|
|
./demo.sh
|
|
```
|
|
|
|
---
|
|
|
|
**🎉 Demo Complete!** Clients will see a professional-grade face recognition system with visual interfaces and intelligent matching capabilities. |