Installation

For OS X Systems

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. You will also need to install flac for OS X. Now run the following commands:

git clone https://github.com/Melissa-AI/Melissa-Core.git
cd Melissa-Core
pip install -r requirements.txt
cp data/memory.db.default data/memory.db
brew install flac

You can configure Melissa with the of the profile population that runs automatically if your project does not contain a profile.json file. You can edit/configure this file later on by editing the profile.json file. 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.

For Linux Systems

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.

sudo apt-get install gcc automake autoconf libtool bison swig python-dev libpulse-dev
sudo apt-get install espeak
sudo apt-get install multimedia-jack
cd Melissa-Core
pip install -r requirements.txt
cp data/memory.db.default data/memory.db

For Windows

Follow the same installation steps as Linux, but take care to add the appropriate environment variables to the path. Melissa might prove to be more troublesome to install for Windows users.