Skip to content

A lovely virtual assistant for OS X, Windows and Linux systems.

License

Notifications You must be signed in to change notification settings

gitter-badger/Melissa-Core

 
 

Repository files navigation

Melissa

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.

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. 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.

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.

For Windows

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.

Configuration

Once you have successfully set up your development environment, open profile.yaml to customise the file and add details about yourself.

Usage Guide

Follow this link for reading the Usage aka Dating Guide.

Contributing

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.

Licence

The MIT License (MIT)

About

A lovely virtual assistant for OS X, Windows and Linux systems.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%