README.md

metadata

title: IRIS Visual Navigation Assistant
emoji: 👁️
colorFrom: indigo
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false

IRIS — Intelligent Real-time Inference System for Visual Assistance

IRIS is an AI-powered assistive navigation tool designed to help visually impaired individuals safely navigate indoor and outdoor spaces.

✨ Key Features

• Live Webcam Scanning: Snap and analyze your real-time surroundings directly from your laptop or phone camera.
• Real-Time Object Detection: Powered by Ultralytics YOLO11 (optimized for CPU/GPU inference).
• Directional Awareness: Classifies obstacles into Left, Center (ahead), and Right navigation zones.
• Priority Engine: Selects the single most crucial obstacle instruction, suppressing noise and information overload.
• Voice Guidance (TTS): Built-in natural audio warnings automatically spoken upon scene analysis.
• Video & Image Uploads: Full-frame annotated previews and step-by-step navigational breakdown.

🛠️ Tech Stack

• Framework: Gradio (Hugging Face Spaces Native)
• Vision Model: Ultralytics YOLO11
• Speech Engine: gTTS (Google Text-to-Speech)
• Computer Vision: OpenCV, NumPy

💻 Local Quickstart

pip install -r requirements.txt
python app.py

Open the local URL displayed in the terminal.