VOCA - Voice Controlled Automation Assistant

VOCA (Voice-Controlled Automation Assistant) is a desktop-based voice assistant application that allows users to interact with their system using voice commands. It can perform tasks such as opening applications, controlling system settings, sending WhatsApp messages, playing YouTube videos, and more.

Features • Voice Interaction - Speech-to-text using microphone input - Text-to-speech responses - Wake word detection ("Computer") • System Automation - Open applications (Chrome, Calculator, Notepad, etc.) - Control system settings (volume, brightness, shutdown, restart) • Web & Media - Open websites dynamically - Play YouTube videos using voice • Chatbot - Built-in rule-based chatbot - Handles general queries (time, date) - Acts as a guide for using the application • WhatsApp Integration - Send WhatsApp messages via voice commands • Contact Management - Import contacts via CSV file - Store contacts in SQLite database - Retrieve contacts for messaging • User Experience - First-time setup popup - Clean UI with chat interface - Voice + text interaction support

Tech Stack

Layer	Technology
Frontend	HTML, CSS, JavaScript, Bootstrap, jQuery
Backend	Python, Eel
Database	SQLite

Project Structure

VOCA/ │ ├── .vscode/ │ ├── c_cpp_properties.json │ └── extensions.json │ ├── engine/ │ ├── command.py │ ├── config.py │ ├── cookies.json │ ├── db.py │ ├── features.py │ └── helper.py │ ├── envvoca/ │ ├── www/ │ ├── assets/ │ │ ├── audio/ │ │ └── img/ │ │ │ ├── particles/ │ │ └── particles.js-master/ │ ├── vendor/ │ ├── controller.js │ ├── index.html │ ├── main.js │ ├── script.js │ └── style.css │ ├── cdn.txt ├── main.py ├── particles.js-master.zip ├── run.py └── voca.db

Prerequisites

Make sure you have the following installed before proceeding:

1. Basic system setup

   • Windows operating system (Windows 10/11)

2. Python environment

   • Verify installation: Python installed (3.10.7)
   • Required libraries installed (pip install)

3. Microphone Access

   • Connected
   • Enabled in system settings
   • Allowed for applications

4. Internet Connection

5. WhatsApp Setup

   • WhatsApp desktop installed
   • User must be logged in

6. Contacts Data (CSV file)

   • Download Contacts CSV from Google contacts

Installation & Setup Steps

Follow these steps in order to run the project successfully:

Step-1: Clone the Repository git clone https://github.com/your-username/voca.git cd voca

Step-2: Create Virtual Environment python -m venv envvoca envvoca\Scripts\activate

Step-3: Install Dependencies pip install eel pip install pyttsx3 pip install SpeechRecognition pip install pyaudio pip install pyautogui pip install pywhatkit pip install screen-brightness-control pip install pvporcupine

Step-4: Import Contacts Click on settings button Upload your .csv file (google contacts format supported) Contacts will be automatically stored on Database

VOCA Command list

1. Application Commands

   • open [application name]

2. Website Command

• open [website name]

3. Youtube Commands

• play [video name] on youtube

4. WhatsApp Commands

• send message to [contact name]
• make a phone call to [contact name]
• make a video call to [contact name]

5. System Control Commands

   • Volume
   • increase volume
   • decrease volume
   • mute
   • brightness
     • increase brightness
     • decrease brightness
   • System
     • system shutdown

6. Chatbot commands

   • hello
   • how are you
   • what is your name
   • what can you do
   • how to open application
   • how to open application
   • how to send message
   • how to call
   • how to video call
   • what is the time
   • tell me the time
   • what is today's date

7. Wakeup Word

   • computer