Melissa is a virtual assistant for OS X, Windows and Linux systems. She currently uses either Google's speech-to-text engine or CMU's Sphinx, OS X's say
command or Linux's espeak
command along with some magical scripting which makes her alive, developed by Tanay Pant and a group of sorcerers.
Clone the project using git
. You can install git and other CLI developer tools by running the following commands:
xcode-select --install
You will need to install PortAudio, PyAudio and Python Weather API. Now run the following commands:
git clone https://github.com/Melissa-AI/Melissa-Core.git
cd Melissa-Core
pip install -r requirements.txt
cp profile.yaml.default profile.yaml
cp memory.db.default memory.db
Melissa is currently configured to use Google STT by default in the profile.yml
file. To use the offline CMU Sphinx STT, open the profile.yml
file to insert sphinx
instead of google
. You will also have to install the Sphinx Base and Pocket Sphinx as well as add the appropriate language models by following the instructions given here.
If you have blink(1), you will have to install its commandline tool by following the instructions on this page.
Install git
and espeak
using your distribution's package manager or build them from their binary files. Follow the same steps as OS X's installation system, starting from installing PortAudio and PyAudio. To play music, you will have to install mpg123 and/or sox.
Follow the same installation steps as Linux, but take care to add the appropriate environment variables to the path. Melissa may prove to be more troublesome to install for Windows users.
Once you have successfully set up your development environment, open profile.yaml
to customise the file and add details about yourself.
Follow this link for reading the Usage aka Dating Guide.
After forking Melissa-AI/Melissa-Core
and making the appropriate changes, open an issue and a pull request. After testing the issue/pull request, your request will be merged.