Virtual-Assistant

A virtual assistant is a software agent that can perform tasks or services for an individual. The term ”chatbot” is also used to refer to virtual assistants. Remember the time, when you were watching Iron Man and wondered to yourself, how cool it would be if you had your own J.A.R.V.I.S? Well, It's time to make that dream into a reality.

Artificial intelligence is the next gen. Imagine how cool it would be if you had your friends over at your house, and all of a sudden you go, "Hey JARVIS, show me some memes.", and JARVIS goes "Sure, sir. Here are the latest Italian memes.", whilst showing you the funniest Italian memes. Cool right?

Well, this is not exactly a chatbot nor JARVIS but to understand it better it is good to know about both.

Virtual assistants use Artificial Intelligence to match user text input to executable commands. It can provide a wide variety of services, These includes:

Weather forecast of any place
Play multimedia files such as audio songs and video songs
Open Applications such as Web browsers, Media players(like vlc), text editors, etc
Open directories in linux, Date and time
Search anything on Google
Open websites of user’s choice
Search anything on Youtube
Open Calendar of any year
Find Restaurants in an area
Send emails using your Gmail account
Arithmetic Calculations

How it all works?

The user's sentence is read and passed through our Natural Language Processing (NLP) code for processing. After the sentence is processed, it's redirected to the action to be performed based on the meaning of the sentence. Our NLP code uses a simplified version of the Multinomial Naive Bayes Algorithm.

The following actions can be performed:

Play audio and media files
Display weather forecasts based on specified location
Display the calendar of a specified year
Perform YouTube video searches
Perform Google searches
Display restaurant recommendations
Send emails

If the virtual assistant does not understand the user’s sentence, a Google search performed.

Artificial Intelligence

Simplified Multinomial Naive Bayes Algorithm

Each classification contains a set of sentences that inputs are matched to. Scores are assigned based on the occurrence of words of an input sentence for each of the classifications. Scores measure the commonality of an input sentence to a classification. The commonality between words and the classifications are important. For example, matching the word “it” is considerably less meaningful than a match for the word “cheese”. The input sentence is assigned the classification of the highest score. This is a simplification as words need to be reduced to their stems.

A sample training set:

Let’s classify a few sample input sentences:

Notice that the classification for “What’s it like outside” found a term in another class but the term similarities to the desired class produced a higher score. By using an equation we are looking for word matches given some sample sentences for each class, and we avoid having to identify every pattern.

Setup

For Ubuntu (Debian-based Linux)

This program uses GNUstep speech engine for the purpose of text to speech. To use this feature few commands are needed:

say converts text to audible speech using the GNUstep speech engine.

$ sudo apt-get install gnustep-gui-runtime
$ say "hello"

Firefox is needed to perform browser tasks such as opening google and youtube.

$ sudo apt-get install firefox

In addition to this, following commands are needed to install the necessary packages.

$ sudo apt-get install libcurl4-openssl-dev
$ sudo apt-get install libjson-c-dev
$ sudo apt-get install libssl0.9.8

For Fedora (RHEL-based Linux)

This program uses Espeak for the purpose of text to speech.

espeak converts text to audible speech.

$ espeak "hello"

Firefox is needed to perform browser tasks such as opening google and youtube.

$ sudo yum install firefox

In addition to this, following commands are needed to install the necessary packages.

$ sudo yum install libcurl libcurl-devel
$ sudo yum install json-c json-c-devel
$ sudo dnf install openssl
$ sudo dnf install openssl-devel

For macOS

GNUstep can be cross-compiled from Linux to run on Apple's macOS, (See: http://wiki.gnustep.org/index.php/Cross_Compiling).

brew install curl
brew install json-c
brew install openssl

Compile

To compile with make:

sudo make install

then execute using virtual_assistant from any location

To remove all build files

make clean

To remove the changes

sudo make uninstall

To compile with gcc:

gcc main.c src/init_config.c $(pkg-config --libs --cflags libcurl) -lssl -lcrypto -ljson-c -std=gnu11

Restaurant

Virtual Assistant can find restaurants in an area.

Weather

This feature requires curl. To use this feature you need to first install curl as follows-

$ sudo apt-get install curl

$ sudo yum install curl

Media

Virtual assistant can play any audio or video files of your choice. For playing media files vlc is needed. Get it here

$ sudo apt-get install vlc

$ sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
$ sudo dnf install vlc

sudo rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm
sudo yum install vlc

Please configure your working directory location before using this feature in config file (value of HOME_DIR)

Youtube Search

Virtual assistant can search anything on youtube.

search youtube for Artificial Intelligence

This will show all the videos on youtube related to Artificial Intelligence. Artificial Intelligence is an example here, you can use anything you want to search.

Google Search

Virtual assistant can search anything on Google.

Calendar

Virtual assistant can show calendar of any year.

open calendar

Emails

In order to send emails using Virtual-Assistant, you need to allow access from less secure apps on your gmail account. Open your gmail account on any browser, click on profile pick and then Google account. In the tab Security you have to activate the parameter Allow access from less secure apps.

Access the gmail service using emails. You will be prompted for your email address and email password. Once you have input those, your email will be saved and you can choose what actions you would like to use. Currently you can only choose to write and send emails. Once you are done writing your message use finish and the email will save and send.

Reminder and Schedule

You can schedule your appointments and work using Virtual-Assistant. It will remind you of the appointments you have on a particular day. You can also access your schedule for any other day by just using the correct words.

In order to add a reminder simply say Add a reminder or Add an appointment or Make a schedule and other things like that. Once there, just enter the required details like date, time and event description.

Every time you run the Virtual-Assistant you will receive notifications of your schedule for that day. If you wish to access schedule for any other day you can say my schedule or what's my appointments.

Arithmetic Calculations

Virtual assistant can perform calculations for you, use math to calculate expressions in the command line using GNUs command line calculator. When you're done, just use quit.

Use man bc on terminal (outside Virtual Assistant) to learn about the command line calculator capabilities.

For long arithmetic expressions, the assistant can bring up the calculator for you by using calculator.

Help

Don't know how to use? Here use help command

help

Contributing Guide

This repository is strictly based on C language. No contributions other than C will be accepted.
When contributing to this repository, please first inform or discuss the change(s) you wish to make via an issue. This helps in letting others know what you're working on.
Before you push your changes to GitHub, make sure that your code compiles and runs without any errors or warnings.
New features are always welcome.

Want to ask something?

Please ask on FAQ or mail me at [email protected]

License

ritwik12/Virtual-Assistant is licensed under the GNU General Public License v3.0

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
Rebranding or renaming this software misguides users about the origin of the original software and should not be done.

Credits

This project intitiated with contributions by Riya and Ritwik. The project is much better and improving with the help of some awesome contributors.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_Riya 💻 📖	_{Rushikesh Nagle} 💻 📖 🚇	_GaelleMarais 💻 📖	_{Vinayak Sankar} 💻 📖	_Matheus 💻	_{Omer Dagan} 💻	_{Jacky Lui} 📖
_pavan-pan 💻	_hardikpnsp 💻	_{Eldar Takach} 💻 📖	_{Roy Mattar} 💻	_{Jayadev V} 📖	_{A. Nummikallio} 💻	_igo4Jesus 💻
_{speedy-software-ch} 💻	_Anindya 💻	_LilyaMel 💻 📖