| --- |
| 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: |
| ```bash |
| pip install -r requirements.txt |
| ``` |
|
|
| 2. Run the application: |
| ```bash |
| 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. |
