Skip to content

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.

License

Notifications You must be signed in to change notification settings

subuhana2303/VaaniRakshak_Offline-Emergency-Voice-Assistant

Repository files navigation

🛡️ 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

Screenshot 2025-06-14 204059

  • 🔴 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

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
  • 🗣️ 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

git clone https://github.com/your-username/VaaniRakshak.git
cd VaaniRakshak

2. Install Dependencies

pip install vosk pyttsx3 pyaudio

💡 If pyaudio installation fails:

pip install pipwin
pipwin install pyaudio

3. Download Vosk Model

Download vosk-model-small-en-us-0.15 and extract it here:

VaaniRakshak/
└── models/
    └── vosk-model-small-en-us-0.15/
        ├── am/
        ├── conf/
        ├── model.conf
        └── ...

▶️ Run the Application

python main.py

🧪 Sample Voice Commands

  • "I need help"
  • "Nearest shelter"
  • "Medical emergency"
  • "Fire alert"
  • "Exit"

📦 Deployment

📁 Build an Executable (.exe) – Windows

Install PyInstaller:

pip install pyinstaller

Then build:

pyinstaller --noconfirm --onefile --windowed main.py

Place models/ and data/ folders alongside the .exe.


🧾 License

This project is licensed under the MIT 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: [email protected]

Github: subuhana2303


“VaaniRakshak speaks for you — when your voice is the only tool you have.”

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages