albertoocello/gpx-route-builder repository overview

⁠GPX Route Builder

AI-powered cycling route planner. Define distance, terrain and waypoints — the system generates three GPX variants with automatic scoring, ready for Garmin, Strava or Komoot.

⁠Features

• Planner: AI designs the route with web-search-backed waypoint selection
• Builder: BRouter + OSM compute three real tracks (asphalt / gravel / scenic) with scoring
• 🔋 Ride Analysis: personalised ebike/bike analysis from your GPX — battery consumption, calories, estimated time, fatigue index, AI advice + downloadable HTML report
• Analyse & Feedback: compare planned vs ridden GPX, add geo-tagged markers, save obstacles
• Multi-language UI (Italian / English)
• Supports Claude, OpenAI, Gemini, Ollama

⁠Quick start

1. Create a folder, add docker-compose.yml + .env with your API key
2. Download start.command (Mac) or start.bat (Windows) — double-click to launch
   • Starts Docker Desktop automatically if not running
   • Pulls the latest image, starts the app, opens the browser

Or from the terminal:

docker compose up

Then open http://localhost:8501⁠

Full instructions: https://github.com/AlbertoOcello/gpx-route-builder⁠

⁠Requirements

• Docker Desktop (Mac / Windows / Linux)
• API key for Claude, OpenAI or Gemini — or Ollama locally (free)