Feres Ride History Visualizer

Export your Feres ride-hailing receipts from Gmail and visualize your ride history in an interactive dashboard.

No external Python packages needed — uses only the standard library.

git clone <this-repo>
cd feres
python3 run.py

The script will guide you through setting up your Gmail credentials.

This will:

1. Connect to your Gmail and download all Feres receipt emails
2. Parse each receipt to extract ride data
3. Generate dashboard.html — open it in your browser

The dashboard shows:

• Total spending, distance, and ride count
• Monthly spending and ride trends
• Day-of-week and hour-of-day patterns
• Cost and distance distributions
• Top destinations and drivers
• Service type breakdown
• Full table of every ride

• All data stays local — nothing is sent to any external service
• The dashboard is a single HTML file you can open offline