roubikon 0.2.0

Flask web app for OSM road-network shortest-path navigation and street-view visualization

roubikon

A Flask-based package for shortest-path route visualization on road networks with street-level imagery.

Features

• Serves a Flask web app with an interactive map interface
• Generates a side-by-side route video combining a 2D map view and street-level photos
• Supports pre-processed street view images or live Google Street View API fetching
• Barrier-free routing with configurable surface and elevation penalties
• Optional LLM-based routing adjustments via Claude API

Installation

pip install roubikon

Usage

1. Extract a road network graph

from roubikon import extract_graph, print_graph_stats

extract_graph("Konstanz, Germany")
print_graph_stats("graph_export.txt")

This downloads the road network for the given city from OpenStreetMap and saves it as graph_export.txt.

2. Start the web app

from roubikon import create_app

app = create_app(
    data_file="graph_export.txt",
    preprocessed_images_folder="augmented_konstanz_rn_small_preprocessed_rough",
)
app.run(debug=True, port=5000)

Then open http://localhost:5000 in your browser.

3. Optional: enable LLM-based routing adjustments

Pass a Claude API key to let users describe their mobility needs in natural language:

app = create_app(
    data_file="graph_export.txt",
    preprocessed_images_folder="augmented_konstanz_rn_small_preprocessed_rough",
    anthropic_api_key="sk-ant-...",
)

Or set it as an environment variable:

export ANTHROPIC_API_KEY="sk-ant-..."

Get an API key at console.anthropic.com.

Road network file format

The graph_export.txt file follows this structure:

<number of vertices>
<number of edges>
<id> <lat> <lon> <elevation>
...
<node_a> <node_b> <length> <surface_type> <wheelchair>
...