README.md

metadata

title: 'Amazon '
sdk: docker
emoji: 📊
colorFrom: green
colorTo: indigo

Amazon India Price Tracker

A multi-user Amazon price tracker web application designed to be deployed on a Linux VPS.

Features

• Track Amazon India product prices in the background.
• Set target price thresholds.
• View price history graphs.
• Receive alerts via Email when the price drops below your target.

Tech Stack

• Backend: Python 3, Flask, Flask-SQLAlchemy, APScheduler
• Frontend: Vanilla HTML, CSS, JavaScript
• Database: PostgreSQL (Designed for Neon.tech)
• Scraping: ScraperAPI using requests and BeautifulSoup
• Visualization: Chart.js

Local Setup

1. Install dependencies:

   pip install -r requirements.txt
   

2. Run the application:

   python app.py
   

   The app uses SQLite by default if DATABASE_URL is not provided.

Deploying to Hugging Face Docker Space

1. Create a new Space on Hugging Face.

2. Select Docker as the Space SDK and choose the Blank template.

3. Upload all files from this directory to your Space repository.

4. Go to the Settings tab of your Space and add the following Variables and secrets:

   • DATABASE_URL: Your PostgreSQL connection string (e.g., from Neon.tech). Format: postgresql://user:password@host/dbname
   • SMTP_SERVER: The SMTP server for sending emails (e.g., smtp.gmail.com).
   • SMTP_PORT: The SMTP port (usually 587).
   • SMTP_USER: The email address used to send alerts.
   • SMTP_PASSWORD: The app password or password for the SMTP user.
   • TELEGRAM_BOT_TOKEN: Your Telegram Bot token obtained from BotFather.

5. The Dockerfile is pre-configured to install dependencies and expose port 7860. The Flask app will run on host='0.0.0.0' and port=7860, which is required by Hugging Face Spaces.

Usage

1. Register: Sign up with a username, password, email, and your ScraperAPI key. Optionally, provide a Telegram Chat ID.
2. Add Item: Paste an Amazon India product URL and set your target price.
3. Dashboard: View your tracked items, current prices, and click "View Graph" to see price history.
4. Alerts: The background scheduler runs every hour, checks prices, and sends alerts if the price drops below your target.