How linh-nguyen123/urbanvibe-mlai2026 works
UrbanVibe: SafeRoute combines pre-trip acoustic-risk route decisions with an on-trip, on-device hazard monitor. A rider chooses a route in the Streamlit app; the app requests a decision, presents route trade-offs, and supports confirmation. During travel, the app starts microphone capture; the engine analyzes audio and can trigger haptic alerts. The README documents Pareto/MCDA/XAI decisions and offline edge-AI monitoring. The excerpts show the main engine flow; map routing inputs and some UI integrations are only partly sampled, so those links are limited to documented or indexed evidence.
Main entry points: app.py Trip dashboard · main_engine.py Audio engine coordinator · decision_engine.py Route decision engine · model_inference.py YAMNet inference
Components 14
Rider experience
- Trip dashboard
ui/app.py - Demo engine
ui/mock_engine.py
Pre-trip decisions
- Route decision engine
engine/decision_engine.py - Route scenarios
data_contract.py
On-trip edge safety
- Audio engine coordinator
engine/main_engine.py - Audio capture buffer
engine/audio_stream.py - YAMNet inference
engine/model_inference.py - Signal analysis
engine/dsp_filter.py - YAMNet model assets
engine/models/yamnet.tflite - Haptic controller
engine/haptic_controller.py
Shared data
- Shared data contracts
data_contract.py
Other components
- Rider
- OpenStreetMap service
- Device microphone
Connections 16
- Rider → Trip dashboard: sets trip
ui/app.py - Trip dashboard → Route decision engine: requests plan
ui/app.py - Route decision engine → Route scenarios: evaluates routes
engine/decision_engine.py - Route decision engine → Shared data contracts: returns decision
engine/decision_engine.py - Trip dashboard → OpenStreetMap service: geocodes places
ui/app.py - Trip dashboard → Demo engine: uses demo data
ui/app.py - Rider → Trip dashboard: starts monitoring
ui/app.py - Trip dashboard → Audio engine coordinator: starts stream
ui/app.py - Audio engine coordinator → Audio capture buffer: captures windows
engine/main_engine.py - Device microphone → Audio capture buffer: provides audio
engine/audio_stream.py - Audio engine coordinator → YAMNet inference: infers hazards
engine/main_engine.py - YAMNet inference → Signal analysis: analyzes signal
engine/model_inference.py - YAMNet inference → YAMNet model assets: loads model
engine/model_inference.py - Audio engine coordinator → Haptic controller: triggers alert
engine/main_engine.py - Audio engine coordinator → Shared data contracts: builds payload
engine/main_engine.py - Trip dashboard → Shared data contracts: renders payloads
ui/app.py