Personal voice assistant - Jarvis
![GitHub followers](https://img.shields.io/github/followers/MichalKacprzak99?style=social)
Table of Contents
What is this project about?
We all know the Iron Man, the genius. He created Jarvis during his lifetime.
It was an artificial intelligence that helped him fight evil.
This project is my approach to the subject of a personal assistant.
Installation
There are two ways to use my library:
$ git clone https://github.com/MichalKacprzak99/jarvis.git
$ cd jarvis/
$ sudo pip install -r requirements.txt
$ pip install jarvis-assistant
How to use it?
After installation create file e.g. "main.py" and write:
from jarvis import Jarvis
if __name__ == '__main__':
jarvis = Jarvis()
jarvis.start()
This will run jarvis and you will be able to enjoy your own voice assistant.
If you wanna have access to feature which give you weather in specific city
you have to do two things:
- Go to https://openweathermap.org/api and create own api key/
- Create .env file in the same folder as your main.py file and create environment variable like this
# .env, private
API_KEY_WEATHER=yours_top_secret_api_key_weather
Basic Personal Assistant
Main class in this project is PersonalAssistant(code). This class represent voice personal assistant with basic features.
The basic implemented features are:
- introduce yourself
- convert text to speech
- handle microphone input
- welcome you, different greeting depending on the time of day
- tell a joke
- shutdown computer
- say goodbye
A lot of phrases which personal assistant will tell are hard coded
so I decided to create simple enum class called BasicPhrases(code).
This is very simple class, which only purpose is to store messages, which will be said by personal assistant.
Jarvis
Jarvis(code)
inherits after PersonalAssistant class and provide extra features:
- set timer
- take note and read the last note
- browse in google
- open specific web page
- search in wikipedia
- tell a weather in given city
Create your own personal assistant
If you want to create your own version of personal assistant, you can simply create a class
which will inherit from the PersonalAssistant.
Then you can add additional functionalities as you like.
Future?
There are many possibilities. More features, GUI, face / voice recognition,
home automation (as in Mark Zuckerberg's project), file management, project creation and git management