samir-attic/bargainbasha

Your AI-powered shopping assistant that predicts prices, detects fake deals, and finds the best bargains in Egypt. 🛒🤖🇪🇬 # BargainBasha 🛒🤖 > Your AI-powered shopping assistant that predicts prices, detects fake deals, and finds you the best bargains in Egypt. --- ## 🎯 What is BargainBasha? BargainBasha is a conversational AI shopping assistant that helps Egyptian shoppers make smarter buying decisions. Unlike traditional price trackers, BargainBasha uses machine learning to: - ✅ **Predict if prices will drop** — not just track history - ✅ **Detect fake deals instantly** — spot artificial price spikes - ✅ **Find better alternatives** — compare across Amazon.eg, Jumia, Noon - ✅ **WhatsApp-first experience** — chat like you would with a friend - ✅ **Smart alerts** — get notified when your target price is hit --- ## 💡 How It Works ``` User: "Is this iPhone 13 at EGP 18,500 a good deal?" BargainBasha: "Not really! 😬 Current: EGP 18,500 Was: EGP 16,200 last week (14% spike!) 30-day low: EGP 15,500 My prediction: 70% chance it'll drop to EGP 16,000 in 7-10 days. Wait for it! 📉 Want me to alert you when it drops?" ``` --- ## 🏗️ Architecture ``` ┌─────────────────────────────────────────┐ │ WhatsApp Bot (Twilio) │ │ Web App (React) │ │ Telegram Bot │ └──────────────┬──────────────────────────┘ │ ┌─────▼─────┐ │ FastAPI │ │ API │ └─────┬─────┘ │ ┌──────────┼──────────┐ │ │ │ ▼ ▼ ▼ Conversa- Price ML Model tional Scraper (XGBoost) AI │ │ │ └──────────┼──────────┘ ▼ ┌────────────────────┐ │ PostgreSQL + │ │ TimescaleDB │ │ Redis Queue │ └────────────────────┘ ``` See docs/ARCHITECTURE.md for detailed system design. --- ## 🚀 Quick Start ### Prerequisites - Python 3.11+ - PostgreSQL 14+ - Redis 7+ - Twilio account (for WhatsApp) ### Installation ```bash # Clone repo git clone github.com cd bargainbasha # Create virtual environment python -m venv venv source venv/bin/activate …