https://github.com/rahulkrsharma2004/hackathon-project
https://github.com/rahulkrsharma2004/hackathon-project
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/rahulkrsharma2004/hackathon-project
- Owner: Rahulkrsharma2004
- Created: 2025-02-28T21:54:27.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T23:39:40.000Z (3 months ago)
- Last Synced: 2025-03-01T00:34:05.870Z (3 months ago)
- Language: JavaScript
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hackathon-Project
# 🗣️ Voice Assistant for Nearby Restaurants (MERN)
## 🚀 Overview
This project is a **voice-enabled restaurant recommendation system** that helps users discover the **top 5 food items** from the nearest restaurants in real-time. It detects the **user's live location**, fetches nearby restaurants from **OpenStreetMap (Nominatim) or Foursquare API**, and announces the recommended food items using the **Speech Synthesis API**.
## 🎯 Features
✅ **Live location detection** using Geolocation API
✅ **Fetch nearby restaurants** from OpenStreetMap or Foursquare API
✅ **Voice assistant functionality** to read out the recommendations
✅ **Top 5 menu item suggestions** for each restaurant
✅ **User-friendly interface** with Tailwind CSS
✅ **MERN stack backend** with MongoDB storage
✅ **Fast API response** using indexed geospatial queries
✅ **Secure & optimized deployment** using cloud services
## 🛠 Tech Stack
### **Frontend:**
- **React.js** - UI framework
- **Tailwind CSS** - Modern styling
- **Axios** - API requests
- **Geolocation API** - Fetch live user location
- **Speech Synthesis API** - Voice assistant functionality
### **Backend:**
- **Node.js** - Server-side JavaScript
- **Express.js** - API framework
- **MongoDB** - NoSQL database for restaurant data
- **Mongoose** - MongoDB ORM
- **OpenStreetMap API (Nominatim)** - Free location-based search
- **Foursquare Places API** - Alternative for finding restaurants
---
## 🔄 How It Works
1️⃣ **User opens the application**
2️⃣ The app **requests live location access**
3️⃣ The backend queries **OpenStreetMap (or Foursquare API)** to find **restaurants near the user**
4️⃣ The database retrieves the **top 5 menu items** for each restaurant
5️⃣ The **Voice Assistant** announces the recommendations
6️⃣ Users can browse through suggestions in the **React UI**
---
## 🔗 LINK
🔹 **Frontend Deployment:** [Frontend Live Link](https://hackathon-project-restro.vercel.app)
🔹 **Demo Video:** [Watch the Video](https://drive.google.com/file/d/1wYqG-zTrB-pCMu_tIj7W-_daY3uYda6j/view?usp=drive_link)
---
## ⚙️ Setup & Installation
### 🔹 Frontend Setup
1. Clone the repository
```sh
git clone https://github.com/Rahulkrsharma2004/Hackathon-Project.git
cd Backend-Voice-assignment
### 🔹 Backend Setup
1. Clone the repository
```sh
git clone https://github.com/Rahulkrsharma2004/Hackathon-Project.git
cd Frontend-Voice-Assignment