Skip to content

darknecrocities/Lumo

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ GuideWay: Smart Stick with Real-Time Alerts (YOLOv11n-Powered)


๐Ÿงฉ Problem

Traditional walking sticks are static tools that do not detect hazards in real time. Visually impaired individuals face daily risks from:

  • ๐Ÿงฑ Obstacles (walls, poles, potholes)
  • ๐Ÿš— Incoming vehicles and moving objects
  • ๐Ÿ—บ๏ธ Poor route awareness and lack of caregiver visibility

These hazards limit their independence and safety during navigation.


๐Ÿ’ก Solution โ€” GuideWay

GuideWay is an AI-powered smart stick system that uses a camera + YOLOv11n model to detect hazards in real time and provide immediate audio and vibration feedback to the user.

The system integrates with a Flutter mobile app and Firebase backend for:

  • Route tracking
  • Community hazard reporting
  • Caregiver monitoring

โš™๏ธ Core Features

๐Ÿง  1. Real-Time Object Detection

  • Detects obstacles, potholes, vehicles, and pedestrians.
  • Uses a mounted mobile phone or small camera on the walking stick.
  • On-device inference using YOLOv11n โ†’ TensorFlow Lite (INT8) for low-latency performance.

Supported Classes: obstacle, pothole, vehicle, pedestrian, stairs, curb

๐Ÿ”Š 2. Real-Time Alerts

  • Voice Feedback: โ€œObstacle ahead, 2 meters.โ€ (Text-to-speech)

  • Vibration Feedback:

    • Short double buzz = obstacle
    • Long pulses = vehicle
    • Triple short buzz = pothole/stairs

๐Ÿ—บ๏ธ 3. Route & Hazard Logging

  • Records walking routes via GPS.
  • Logs detected hazards with timestamp, type, and approximate distance.
  • Uploads anonymized hazard data to Firebase Firestore.

๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘ง 4. Caregiver Integration

  • View frequent hazard zones.
  • Receive emergency alerts via Firebase Cloud Messaging (FCM).

๐Ÿง  Technology Stack

Layer Technology Description
Model YOLOv11n Lightweight object detection model
Training Ultralytics (PyTorch) Train YOLOv11n using labeled dataset
Model Conversion TensorFlow Lite Convert YOLOv11n to .tflite (INT8)
Frontend App Flutter Camera, vibration, TTS integration
Backend Firebase Cloud database, auth, FCM, hosting
Maps & Location Google Maps + GPS Navigation & route tracking
Cloud Analytics Firebase Functions + BigQuery Aggregate hazard & route data

๐Ÿงฐ YOLOv11n Model Implementation

๐Ÿ“ธ Dataset

  • Custom dataset of real walking environments.
  • 6โ€“8 classes: obstacle, pothole, vehicle, pedestrian, stairs, curb.
  • Augmented for varying lighting and weather conditions.
  • Annotated in YOLO format (Roboflow / LabelImg).

๐Ÿ‹๏ธ Training (Colab / Local)

!pip install ultralytics

from ultralytics import YOLO

model = YOLO("yolov11n.pt")

model.train(
    data="guideway_data.yaml",
    epochs=150,
    imgsz=640,
    batch=16,
    name="guideway_yolov11n"
)

๐Ÿ”„ Export to TensorFlow Lite

# Float32 export
model.export(format="tflite")

# INT8 quantized export
model.export(format="tflite", int8=True, representative_data="rep_dataset/")

โšก On-Device Inference (Flutter + TFLite)

final interpreter = await Interpreter.fromAsset('guideway_yolov11n.tflite');
final input = preprocessCameraFrame(image);
final output = List.filled(outputSize, 0.0).reshape([1, outputSize]);
interpreter.run(input, output);
final detections = postProcess(output);
handleDetections(detections);

๐Ÿ” Firebase Integration

Collections:

  • /users โ€” user profiles, linked caregiver IDs
  • /hazards โ€” {type, lat, lon, timestamp, severity}
  • /routes โ€” route logs, polylines, timestamps
  • /emergencies โ€” SOS events

Realtime Database:

  • Live GPS coordinates

Cloud Functions:

  • Aggregate hazard data hourly
  • Send FCM alerts to caregivers

๐Ÿšจ Emergency Mode

  • Shake stick or tap SOS button triggers immediate location sharing.
  • Sends emergency alert to caregiver device.
  • Optional call trigger (Twilio / phone intent).

๐Ÿ“Š Dashboard Analytics Examples

Metric Description Visualization
Hazard Frequency Number of hazards per day Bar chart
Hotspots Common hazard locations Map heatmap
Average Safe Distance Avg distance before hazard alert Line chart
SOS Events Number of emergencies Pie chart
User Routes Daily walking routes Map overlays

๐Ÿงฉ Extensions

  • GPS-based safe route navigation
  • Community hazard map (โ€œSafe Pathsโ€ & โ€œDanger Zonesโ€)
  • Voice assistant mode (โ€œDescribe aheadโ€ commands)
  • Offline mode with cached model & maps
  • Edge TPU support for Raspberry Pi smart sticks

โšก Performance Optimizations

  • Skip frames for 10โ€“15 FPS on low-end phones
  • Crop camera feed to walking-level region
  • Float16 quantization if INT8 fails
  • Haptic + TTS feedback prioritization: vehicles > obstacles

๐Ÿงญ Project Roadmap

Phase Focus Deliverable
Phase 1 Data Collection & Labeling Dataset + annotations
Phase 2 Model Training & Export YOLOv11n + TFLite
Phase 3 Flutter App Integration Real-time detection + alerts
Phase 4 Firebase Backend Logging + caregiver tracking
Phase 5 Dashboard & Analytics Map heatmaps + insights
Phase 6 Field Testing Accuracy & latency tuning
Phase 7 Scale & Community Launch Deploy & crowdsource hazards

๐Ÿ’ฌ Example User Scenario

Maria, a visually impaired user, attaches her phone to the GuideWay stick and begins her morning walk:

  • Detects a pothole 2 meters ahead โ†’ vibrates quickly
  • Car approaches from left โ†’ โ€œVehicle incoming, step asideโ€
  • Caregiver reviews route later โ†’ sees recurring hazard

๐Ÿง  Outcome & Impact

  • Improves mobility independence for visually impaired users
  • Builds crowdsourced safety map
  • Empowers caregivers with insights for better route planning
  • Demonstrates ethical AI through inclusive design and real-time assistance

About

team portfolio making group 3 app

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • HTML 46.3%
  • Dart 34.8%
  • C++ 9.3%
  • CMake 7.0%
  • Swift 1.1%
  • Ruby 1.0%
  • Other 0.5%