gitwtfhub

wtf is metro-navigation-public?

tonylejt/metro-navigation-public — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · researcherComplexity · 4/5Setup · hard

TL;DR

A research prototype that uses computer vision and spoken guidance to help visually impaired people navigate metro stations, not yet validated as a safety tool.

Mindmap

Mindmap is still cooking. Refresh in a few.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Study or extend a phase-aware guidance system for accessible metro navigation research.

REASON 2

Run inference on a video or camera feed to see detected landmarks, walkable paths, and spoken guidance.

REASON 3

Benchmark how fast the detection and segmentation components run on a given machine.

REASON 4

Inspect the fusion and state-machine logic behind combining multiple AI models into navigation guidance.

What's in the stack?

PythonPyTorchYOLO11SegFormerOpenCV

How it stacks up

tonylejt/metro-navigation-public2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity4/52/53/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires separately obtained pretrained model weight files, a CUDA GPU for real-time use, and a local text-to-speech backend.

Wtf does this do

This project is a research prototype for a computer vision system that could help visually impaired people navigate metro stations. It watches video from a camera, using several AI models together: two object detectors trained to spot metro landmarks, warning signs, and station signage, plus a segmentation model that identifies safe walking paths and curb ramps in the image. A guidance system then combines all of this into spoken instructions, moving through different modes such as searching for a safe starting area, following a tactile path, and warning about obstacles or announcing arrival at a destination. The README is direct about what this project is and is not. It states clearly that this is a research prototype, not a certified mobility aid, and that it has not been tested for safe unsupervised use. It should not be relied on as someone's only means of navigation. The repository currently includes the code for running the system and benchmarking its components, but it does not yet include the full training pipeline, the dataset used to train the models, or the official test data, so results cannot be fully reproduced by an outside user yet. To run it, a person needs Python 3.10 or 3.11, ideally a CUDA-capable graphics card for real-time speed, though it can run on a CPU for basic testing, plus a text-to-speech engine and three separate pretrained model weight files placed in a specific folder. Once set up, the tool can process a video file or a live camera feed, optionally displaying results on screen and speaking instructions aloud, and it can save an annotated video along with a log of performance data. A separate benchmarking command measures how fast each part of the pipeline runs. The authors are honest about the system's current limits: it has only been tested on a single, relatively uncrowded route, and its reported accuracy does not prove it is safe in crowded, poorly lit, rainy, or unfamiliar stations. Turning this into something safe to deploy would require substantially more testing, safety engineering, and validation with real users.

Yoink these prompts

Prompt 1
Help me set up a Python virtual environment and install metro-navigation-public with its dependencies.
Prompt 2
Explain what the phase-aware guidance state machine does and how it switches between modes.
Prompt 3
Show me how to run metro-nav on a sample video file with display and speech enabled.
Prompt 4
What are the safety limitations described in this repository, and why isn't it ready for real-world use?

Frequently asked questions

wtf is metro-navigation-public?

A research prototype that uses computer vision and spoken guidance to help visually impaired people navigate metro stations, not yet validated as a safety tool.

What language is metro-navigation-public written in?

Mainly Python. The stack also includes Python, PyTorch, YOLO11.

How hard is metro-navigation-public to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is metro-navigation-public for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.