https://github.com/prthd/ai-powered-voice-assisted-object-locator
🔍 Real-time object detection with voice command integration using YOLOv5 (Objects365), OpenCV, MediaPipe, spaCy NLP, and SpeechRecognition. Enhances accessibility by guiding users to locate indoor objects with directional feedback relative to their position. Ideal for smart-home, accessibility tech, and assistive applications.
https://github.com/prthd/ai-powered-voice-assisted-object-locator
computer-vision nlp object-detection opencv python real-time-systems spacy speech-recognition voice-assistant yolov5
Last synced: 30 days ago
JSON representation
🔍 Real-time object detection with voice command integration using YOLOv5 (Objects365), OpenCV, MediaPipe, spaCy NLP, and SpeechRecognition. Enhances accessibility by guiding users to locate indoor objects with directional feedback relative to their position. Ideal for smart-home, accessibility tech, and assistive applications.
- Host: GitHub
- URL: https://github.com/prthd/ai-powered-voice-assisted-object-locator
- Owner: PrthD
- Created: 2025-02-08T06:17:46.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-08T20:58:01.000Z (about 1 month ago)
- Last Synced: 2025-04-08T21:33:58.323Z (30 days ago)
- Topics: computer-vision, nlp, object-detection, opencv, python, real-time-systems, spacy, speech-recognition, voice-assistant, yolov5
- Language: Python
- Homepage:
- Size: 4.28 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI-powered-Voice-assisted-Object-Locator (ECE 492 Capstone G08):
## Group members:
1. Parth Dadhania (SID: 1722612)
2. Het Bharatkumar Patel (SID: 1742431)
3. Chinmoy Sahoo (SID: 1729807)
4. Dang Nguyen (SID: 1740770)
## 📜 Setup Guide for Team (WSL & Raspberry Pi)
This guide ensures that every team member can **seamlessly** set up, configure, and run the **AI-powered Voice-Assisted Object Locator (AIVOL)** project in an **identical development environment** across **WSL Ubuntu & Raspberry Pi**.
---
## 🚀 Quick Setup Guide for AIVOL
📌 **Follow these steps carefully to ensure a smooth and identical setup on your machine.**
🔹 **Supported Platforms:**
✅ **Windows Subsystem for Linux (WSL) Ubuntu (Development)**
✅ **Raspberry Pi OS (Deployment/Production)**
---
## 📌 Step 1: Clone the GitHub Repository
Navigate to your **desired project directory** and run:
```bash
git clone https://github.com/PrthD/AI-powered-Voice-assisted-Object-Locator.git
cd AI-powered-Voice-assisted-Object-Locator
```
---
## 📌 Step 2: Run the Setup Script
Make the setup script executable:
```bash
chmod +x setup.sh
```
Then, run the script:
```bash
./setup.sh
```
This will:
✔ **Install necessary system dependencies**
✔ **Ensure Python 3.11.4 is installed using pyenv**
✔ **Create and activate a virtual environment**
✔ **Install all Python dependencies from `requirements.txt`**
✔ **Download YOLO model weights**
---
## 📌 Step 3: Verify Installation
Once the setup is complete, verify that everything is correctly installed:
### **3.1 Check Python Version**
```bash
python --version
```
✔ Should output: `Python 3.11.4`
### **3.2 Check Installed Packages**
```bash
pip list
```
✔ Should list all dependencies (e.g., `opencv-python`, `SpeechRecognition`, `PyAudio`, `pyttsx3`, `mediapipe`, `ultralytics`, `torch`, `torchvision`).
### **3.3 Verify YOLO Model is Installed**
```bash
ls -lh models/yolo/yolo.weights
```
✔ Should show the **YOLO model weights file** (`yolo.weights`).
---
## 📌 Step 4: Running the Project
Now that everything is set up, run the main program:
```bash
python3 src/main.py
```
---
## 📌 Troubleshooting Guide
If you encounter any issues during the setup, the script will now immediately exit and display an error message. For example, if Python or the dependencies are not installed correctly, you will see a message like:
```bash
❌ An error occurred during the setup. Please review the error messages above and refer to the Troubleshooting Guide in README.md.
```
### Common troubleshooting steps:
⚠️ pyenv not found:
Run the following commands to add pyenv to your shell environment and restart your terminal:
```bash
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"
exec "$SHELL"
```
⚠️ Dependency Installation Failures:
Ensure that you are connected to the internet and that your system package manager (apt) has successfully updated. If errors persist, try running the setup script again after addressing any specific error messages shown.
---
## 📌 Updating the Project
Whenever there’s a new update, run:
```bash
git pull origin main
./setup.sh
```
---
## 🎯 Summary of Steps
| Step | Description |
| ---- | -------------------------------------------------------- |
| 1️⃣ | **Clone the GitHub repository** |
| 2️⃣ | **Run the `setup.sh` script** |
| 3️⃣ | **Verify installation** (`python --version`, `pip list`) |
| 4️⃣ | **Run the main program** (`python src/main.py`) |
| 5️⃣ | **Troubleshoot issues if needed** |
| 6️⃣ | **Pull updates and re-run `setup.sh`** |
---
## 🎉 You're Now Ready to Develop & Deploy!
🚀 **This guide ensures that all team members have an identical setup, making collaboration seamless and error-free!** 🚀