Files
suivi-courses/README.md
2026-02-06 17:31:09 +01:00

1.7 KiB

Grocery Receipt Tracker

A database application to track your grocery receipts (PDF/email format) and monitor price evolution over time.

Overview

This project helps you:

  • Import and store your grocery receipts from email attachments or PDF files
  • Extract item details and prices from receipt images/PDFs
  • Track price changes for the same items across different stores and over time
  • Analyze spending patterns and identify price trends
  • Compare costs to find the best deals and optimize your shopping habits

Features

  • Import receipts from email attachments or PDF files
  • Extract item details and prices using OCR technology
  • Store receipt details (date, store, items, prices, total)
  • Track price evolution for the same items over time
  • Compare prices for the same items across different stores
  • Visualize price changes with charts and graphs
  • Generate reports on spending patterns and savings opportunities

Getting Started

  1. Clone this repository
  2. Install dependencies: pip install -r requirements.txt
  3. Set up the database: python manage.py migrate
  4. Start the application: python manage.py runserver
  5. Import your first receipt by uploading a PDF or forwarding an email receipt

Usage

  • Upload your grocery receipts (PDF or email attachments)
  • The system will extract item details and prices using OCR
  • View your receipt history and price tracking dashboard
  • Use the comparison tools to analyze price changes over time
  • Export reports for analysis or sharing

Contributing

We welcome contributions! Please read our contributing guidelines before submitting pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.