discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
homelabforge/mygarage · source
Snapshot 0 · 2026-11-04T12:47:28Z · Python · MIT
Content fingerprint
d228aa0c7be0edb721576b8f8e94a99f4f5d4216fe0d3973b2fdfa498ff53cb8GitHub description at capture
Self-hosted vehicle maintenance tracking for vehicle enthusiasts
README at capture
<div align="center"> # MyGarage Self-hosted vehicle maintenance tracking for the whole household: service history, reminders, fuel, tires, insurance, documents and live OBD2 telemetry. [](https://github.com/homelabforge/mygarage/actions/workflows/ci.yml) [](https://github.com/homelabforge/mygarage/actions/workflows/codeql.yml) [](https://github.com/homelabforge/mygarage/actions/workflows/publish.yml) [](TRANSLATIONS.md) [](https://github.com/homelabforge/mygarage/pkgs/container/mygarage) [](https://www.python.org) [](https://react.dev) [&label=Bun&color=000000&logo=bun&logoColor=white&prefix=v)](https://bun.sh) [&label=Node&color=5FA04E&logo=nodedotjs&logoColor=white&prefix=v)](https://nodejs.org) [](LICENSE) [](https://discord.gg/YG2vV32NBg) </div> --- ## Features - **Vehicles** - Cars, motorcycles, boats, RVs and equipment. VIN decoding via NHTSA, maintenance specs, photos, window stickers, recalls and warranties. - **Service history** - Visits with line items and attachments, with parts drawn from your own supplies inventory. - **Reminders** - Recurring rules by distance, months or engine hours, anchored on real service history. Reminder packs, snooze, and notifications to Discord, Telegram, ntfy, Pushover, Gotify, Slack, Matrix or email. - **Fuel and charging** - Fill-ups, DEF and propane, EV/PHEV charge sessions, economy trends, and imports from Fuelio, Drivvo and Tesla/ABRP. - **Tires** - Tread and pressure per position, mount history, rotations, seasonal sets, storage and wear projection. - **LiveLink** - Live OBD2 data, drive sessions, GPS trips and DTCs from a WiCAN device (HTTPS or MQTT), Torque Pro, any MQTT source, or Mopeka propane sensors. DTCs show up when the device sends `DIAGNOSTIC_TROUBLE_CODES`; stock WiCAN firmware doesn't read codes on its own. See the [LiveLink setup guide](docs/LIVELINK_SETUP.md). - **Insurance** - Household policies spanning vehicles, standard coverages, renewals, and import from a declarations page. - **Documents and places** - Registration, insurance papers and manuals, OCR import of insurance declarations and window stickers (fuel receipts too, with the opt-in LLM parser), plus a map of nearby shops, fuel and charging. - **Household** - Separate accounts, vehicle sharing and transfers, and a family dashboard. Run with no auth, local accounts, or any OIDC provider. - **Units and languages** - Imperial, metric or any mix per quantity, a per-vehicle odometer unit, nine languages and 17 currencies. - **Countries** - A country per person, per vehicle or per instance drives national defaults from data-driven [country profiles](docs/country-profiles.md) (EU baseline, France, Luxembourg, Germany, Belgium, Italy, Netherlands, Spain). - **Also** - Analytics and PDF reports, calendar, global search, a [gethomepage](https://gethomepage.dev) widget API, inbound webhooks and Telegram fuel commands, JSON and CSV backup and export, an installable PWA, and opt-in [AI helpers](docs/ai-features.md): receipt drafts, Ask My Garage, and document reading with a vision model. --- ## Get started One container with a `/data` volume. Follow the [Quick Start](https://github.com/homelabforge/mygarage/wiki/Quick-Start), or the [Installation guide](https://github.com/homelabforge/mygarage/wiki/Installation) for reverse proxies, subpath hosting, PostgreSQL and authentication. MyGarage starts without authentication so you can look around. Turn on local accounts or OIDC in Settings before exposing it. --- ## Support - **Documentation**: [GitHub Wiki](https://github.com/homelabforge/mygarage/wiki) - **Website**: [homelabforge.io/builds/mygarage](https://homelabforge.io/builds/mygarage/) - **Bug reports**: [GitHub Issues](https://github.com/homelabforge/mygarage/issues) - **Discussions**: [GitHub Discussions](https://github.com/homelabforge/mygarage/discussions) or [Discord](https://discord.gg/YG2vV32NBg) --- ## Translations See [Translation Status](TRANSLATIONS.md) for language coverage and how to contribute. --- ## License MIT License. See [LICENSE](LICENSE). --- ## Acknowledgments Built for homelabbers who want to track vehicle maintenance without sending data to third-party services. VIN decoding powered by the [NHTSA vPIC API](https://vpic.nhtsa.dot.gov/). ### Development Assistance MyGarage was developed through AI-assisted pair programming with **Claude** and **Codex**, combining human vision with AI capabilities for architecture, security patterns, and implementation.