drumsergio/pumperly repository overview

⁠Pumperly

Open-source fuel and EV route planner with live prices from 22 countries. Self-hostable.

Pumperly is a map of fuel prices and EV chargers with a route planner on top. Pick a destination and it draws the route, lists every station along it with its price and the minutes a stop would add, and plans the cheapest places to fill up. Prices come from government and community sources in 22 countries with no key to set. Try it at pumperly.com⁠, or run your own copy with Docker Compose.

⁠Features

• Shows every station on the map coloured by price, green for the cheapest 5% on screen to purple for the most expensive.
• Lists the stations along your route with the extra minutes each one costs, and hides the ones past the detour you allow.
• Plans the cheapest fuel stops for the trip from your tank size, consumption and how full you start.
• Keeps prices fresh from 22 countries with no API key, and from two more with a free key. Supports 39 countries in all, each listed with its status.
• Shows EV chargers from the official registries of Spain and Germany and from Open Charge Map everywhere else.
• Converts prices into 37 currencies with the European Central Bank's daily rates, and speaks 17 languages.
• Makes any station or route a link you can share.
• Runs as one container next to PostGIS, with Valhalla and Photon optional, and keeps no accounts, no analytics and no tracking cookies.

⁠Quick start

git clone https://github.com/GeiserX/Pumperly.git && cd Pumperly && cp .env.example .env
docker compose -f docker/docker-compose.yml up -d

Open http://localhost:3000. The map fills country by country over the next few minutes as the scrapers run. This first run has the price map only: routes and address search need Valhalla and Photon, which Full stack with routing and geocoding⁠ adds. Run with Docker Compose⁠ explains the settings in .env.

⁠Documentation

The full documentation lives at geiserx.github.io/Pumperly⁠.

• Run with Docker Compose⁠: the shipped compose file, the settings in .env, and what to do before exposing it.
• What happens on first start⁠: the scrapers, their timetable, and how to check that it worked.
• Full stack with routing and geocoding⁠: Valhalla and Photon, with the compose file that runs all of it.
• The map⁠ and Planning a route⁠: every control, the price colours, detours and the refuel planner.
• Coverage and status⁠: every country, its source and whether it works today.
• Environment variables⁠ and the HTTP API⁠.

⁠Related projects

pumperly-mcp⁠ (MCP server), pumperly-ha⁠ (Home Assistant), n8n-nodes-pumperly⁠ (n8n node, archived). Also listed on awesome-europe⁠ and ArtifactHub⁠.

⁠License

AGPL-3.0-or-later⁠. If you run a modified version as a network service, you must offer its source code to the users of that service.