pip install velorail
# alternatively if your pip is not a python3 pip
pip3 install velorail 
# local install from source directory of velorail 
pip install .

pip install velorail  -U
# alternatively if your pip is not a python3 pip
pip3 install velorail -U

velorail -h
usage: velorail [-h] [-a] [--apache APACHE] [-c] [-d]
                [--debugServer DEBUGSERVER] [--debugPort DEBUGPORT]
                [--debugRemotePath DEBUGREMOTEPATH]
                [--debugLocalPath DEBUGLOCALPATH] [-l] [-i INPUT] [-rol]
                [--host HOST] [--port PORT] [-s] [-V] [-v] [-rp ROOT_PATH]
Multimodal bike and train route planning support
options:
  -h, --help            show this help message and exit
  -a, --about           show about info [default: False]
  --apache APACHE       create an apache configuration file for the given
                        domain
  -c, --client          start client [default: False]
  -d, --debug           show debug info [default: False]
  --debugServer DEBUGSERVER
                        remote debug Server
  --debugPort DEBUGPORT
                        remote debug Port
  --debugRemotePath DEBUGREMOTEPATH
                        remote debug Server path mapping - remotePath - path
                        on debug server
  --debugLocalPath DEBUGLOCALPATH
                        remote debug Server path mapping - localPath - path on
                        machine where python runs
  -l, --local           run with local file system access [default: False]
  -i INPUT, --input INPUT
                        input file
  -rol, --render_on_load
                        render on load [default: False]
  --host HOST           the host to serve / listen from [default: localhost]
  --port PORT           the port to serve from [default: 9876]
  -s, --serve           start webserver [default: False]
  -V, --version         show program's version number and exit
  -v, --verbose         show verbose output [default: False]
  -rp ROOT_PATH, --root_path ROOT_PATH
                        path to pdf files [default:
                        /Users/wf/Library/Python/3.12/lib/python/site-
                        packages/velorail_examples]

curl "https://velorail.bitplan.com/api/routes/bbox?south=50.75&west=6.05&north=50.80&east=6.12&sources=train,bike&limit=3"
{
  "status": "ok",
  "bbox": {"south": 50.75, "west": 6.05, "north": 50.8, "east": 6.12},
  "sources": ["train", "bike"],
  "records": [
    {"rel": "...relation/...", "route_type": "railway", "name": "Ronheider Rampe", "source": "train"},
    {"rel": "...relation/...", "route_type": "train", "ref": "ES", "name": "Eurostar: Dortmund → Köln → Bruxelles → Paris", "source": "train"},
    {"rel": "...relation/...", "route_type": "bicycle", "ref": "D4", "name": "[D4] Mittelland-Route (Nordrhein-Westfalen)", "source": "bike"}
  ]
}

curl "https://velorail.bitplan.com/api/gpx/bbox?gpx_url=https://www.topografix.com/fells_loop.gpx&south=42.40&west=-71.20&north=42.50&east=-71.00&mode=overlap"
{
  "status": "ok",
  "source": "https://www.topografix.com/fells_loop.gpx",
  "mode": "overlap",
  "bbox": {"south": 42.4, "west": -71.2, "north": 42.5, "east": -71.0},
  "route_count": 2,
  "records": [
    {"name": "BELLEVUE", "kind": "route", "point_count": 46,
     "bbox": {"south": 42.43095, "west": -71.122845, "north": 42.46711, "east": -71.105116}}
  ]
}

curl -X POST -H "Content-Type: application/gpx+xml" \
  --data-binary @velorail_examples/aachen_bike_loop.gpx \
  "https://velorail.bitplan.com/api/gpx/bbox?south=50.75&west=6.05&north=50.80&east=6.12&mode=contained"
{
  "status": "ok",
  "source": "posted",
  "mode": "contained",
  "bbox": {"south": 50.75, "west": 6.05, "north": 50.8, "east": 6.12},
  "route_count": 1,
  "records": [
    {"name": "Aachen city loop", "kind": "track", "point_count": 6,
     "bbox": {"south": 50.7679, "west": 6.0836, "north": 50.7815, "east": 6.1006}}
  ]
}

curl "https://velorail.bitplan.com/api/routes/bbox?south=51&west=6.05&north=50&east=6.12"
{"status": "error", "message": "south 51.0 is north of north 50.0"}