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 Google Chrome. 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
cd melissa
cp data/memory.db.default data/memory.db
brew install flac
FLASK_APP=melissa/__main__.py flask run

Open http://127.0.0.1:5000 on Google Chrome.

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.

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. 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
git clone https://github.com/Melissa-AI/Melissa-Core.git
cd Melissa-Core
pip install -r requirements.txt
cd melissa
cp data/memory.db.default data/memory.db
cd ..
FLASK_APP=melissa/__main__.py flask run

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 relatively troublesome to install for Windows users.