https://github.com/subuhana2303/vaanirakshak_offline-emergency-voice-assistant
VaaniRakshak is an offline voice assistant built for disaster scenarios, enabling hands-free emergency support without internet connectivity. It assists users in locating shelters, requesting help, and accessing life-saving information through voice interaction.
https://github.com/subuhana2303/vaanirakshak_offline-emergency-voice-assistant
audio-input json pyaudio pyttsx3 speech-recognition text-to-speech tkinter-gui vosk
Last synced: 3 months ago
JSON representation
VaaniRakshak is an offline voice assistant built for disaster scenarios, enabling hands-free emergency support without internet connectivity. It assists users in locating shelters, requesting help, and accessing life-saving information through voice interaction.
- Host: GitHub
- URL: https://github.com/subuhana2303/vaanirakshak_offline-emergency-voice-assistant
- Owner: subuhana2303
- License: other
- Created: 2025-06-14T14:50:00.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-28T06:36:21.000Z (4 months ago)
- Last Synced: 2025-06-28T07:34:12.836Z (4 months ago)
- Topics: audio-input, json, pyaudio, pyttsx3, speech-recognition, text-to-speech, tkinter-gui, vosk
- Language: Python
- Homepage: https://drive.google.com/file/d/1_eOUWAw4IftcjcFsCsrCU14sKMkdXI07/view?usp=drive_link
- Size: 38.5 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛡️ VaaniRakshak: Offline Emergency Voice Assistant
**VaaniRakshak** is an intelligent, offline voice assistant tailored for disaster and emergency response scenarios. Designed to operate **without internet connectivity**, it provides real-time assistance using voice commands, helping users locate shelters, access emergency services, and receive critical information — even in infrastructure-compromised environments.
---
## 📸 Output Preview
### 🖼️ VaaniRakshak GUI Screenshot
- 🔴 Emergency-themed interface
- 🎙️ Start/Stop voice control
- ✍️ Manual text input
- 🧭 Real-time updates and response messages
---
### 🎬 Demo Video
🔗 [Watch the video demo on Google Drive](https://drive.google.com/file/d/1_eOUWAw4IftcjcFsCsrCU14sKMkdXI07/view?usp=drive_link)
> ✅ *Watch the assistant recognize phrases like “I need help”, “medical emergency”, and reply with shelter info, alerts, and voice feedback.*
---
## 📌 Features
- 🎙️ **Offline Speech Recognition** using [Vosk](https://alphacephei.com/vosk/)
- 🗣️ **Text-to-Speech Synthesis** with `pyttsx3`
- 🖥️ **User-Friendly GUI** powered by Tkinter
- 📡 **Emergency Response Engine** with shelter lookup and SMS alert simulation
- 🌍 **Location-aware guidance** (mocked for offline support)
- 🔧 Fully modular and configurable architecture
---
## 🧠 Use Case
> “In disaster scenarios where internet access is disrupted, **VaaniRakshak** enables users to interact with emergency services and systems **hands-free, offline, and in real-time** — just by speaking.”
---
## 🏗️ Architecture Overview
```
+---------------------+
| GUI Interface |
+----------+----------+
↓
+----------v----------+
| Voice Assistant | <-- Orchestrator
+----------+----------+
↓
+----------v----------+
| Speech Processor | <-- STT + TTS
+----------+----------+
↓
+----------v----------+
| Emergency Handler | <-- Logic + Lookup
+----------+----------+
↓
+----------v----------+
| Configuration Layer |
+---------------------+
```
---
## 💻 Technology Stack
| Layer | Tool/Library |
|------------------|-------------------------------|
| Programming Lang | Python 3.11 |
| Speech Recognition | Vosk (offline) |
| Text-to-Speech | pyttsx3 |
| Audio Input/Output| PyAudio |
| GUI | Tkinter (standard Python GUI) |
| Data Storage | JSON |
---
## 📂 Project Structure
```
VaaniRakshak/
├── main.py # Entry point
├── voice_assistant.py # Core controller
├── speech_processor.py # STT + TTS
├── emergency_handler.py # Logic/Response
├── gui_interface.py # Tkinter GUI
├── config.py # Configuration
├── data/
│ ├── emergency_phrases.json
│ ├── shelters.json
│ └── locations.json
├── models/
│ └── vosk-model-small-en-us-0.15/
└── README.md
```
---
## ⚙️ Installation
### 1. Clone the Repository
```bash
git clone https://github.com/your-username/VaaniRakshak.git
cd VaaniRakshak
```
### 2. Install Dependencies
```bash
pip install vosk pyttsx3 pyaudio
```
> 💡 If `pyaudio` installation fails:
```bash
pip install pipwin
pipwin install pyaudio
```
---
### 3. Download Vosk Model
Download [`vosk-model-small-en-us-0.15`](https://alphacephei.com/vosk/models) and extract it here:
```
VaaniRakshak/
└── models/
└── vosk-model-small-en-us-0.15/
├── am/
├── conf/
├── model.conf
└── ...
```
---
## ▶️ Run the Application
```bash
python main.py
```
---
## 🧪 Sample Voice Commands
- `"I need help"`
- `"Nearest shelter"`
- `"Medical emergency"`
- `"Fire alert"`
- `"Exit"`
---
## 📦 Deployment
### 📁 Build an Executable (.exe) – Windows
Install [PyInstaller](https://pyinstaller.org/):
```bash
pip install pyinstaller
```
Then build:
```bash
pyinstaller --noconfirm --onefile --windowed main.py
```
Place `models/` and `data/` folders alongside the `.exe`.
---
## 🧾 License
This project is licensed under the [MIT License](LICENSE).
---
## 🤝 Contributing
Pull requests are welcome! If you'd like to contribute improvements, localization, or accessibility features, please open an issue.
---
## 📅 Changelog
- **2025-06-14** – Initial release with full offline assistant functionality
---
## 👤 Author
**Subuhana B**
*Developer | Tech for Social Good | Voice AI Enthusiast*
**email:** subuhanabasheer41@gmail.com
**Github:** subuhana2303
---
> “VaaniRakshak speaks for you — when your voice is the only tool you have.”