Skip to content

feat(plugin): add Fuelly.com as a data source plugin #34

@jschloman

Description

@jschloman

Summary

Add a new data source plugin for Fuelly.com to retrieve personal vehicle fuel economy and fill-up history, allowing it to be included in the autobiographical narrative alongside listening and location data.

Proposed behaviour

  • Collection phase: Authenticate with Fuelly (API or scrape) and download the user's vehicle fill-up history (date, mileage, gallons, MPG, cost, notes, vehicle)
  • Display phase: Surface fuel economy trends, total miles driven, cost over time, and milestone events (e.g. first fill-up, best/worst MPG) in the Streamlit dashboard
  • Narrative integration: Include driving milestones in the autobiographical timeline (e.g. "You drove 10,000 miles in 2023")

Plugin design notes

Following the existing plugin design principles:

  • Plugin lives in plugins/sources/fuelly.py
  • Download-then-display pattern: collection downloads to a local JSON/CSV file; display reads from it
  • Credentials via environment variables (AUTOBIO_FUELLY_USERNAME, AUTOBIO_FUELLY_PASSWORD or API key if available)
  • Fuelly exposes a public profile page at fuelly.com/driver/{username} — scraping may be needed if no public API exists

References

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions