installation.md 2.5 KB

Kalliope installation

Prerequisites

Please follow the right link bellow to install requirements depending on your target environment:

Installation

Method 1 - User install using the PIP package

You can install kalliope on your system by using Pypi:

sudo pip install kalliope

Method 2 - Manual setup using sources

Clone the project:

git clone https://github.com/kalliope-project/kalliope.git
cd kalliope

Install the project:

sudo python setup.py install

Method 3 - Developer install using Virtualenv

Install the python-virtualenv package:

sudo apt-get install python-virtualenv

Clone the project:

git clone https://github.com/kalliope-project/kalliope.git
cd kalliope

Generate a local python environment:

virtualenv venv

Install the project using the local environment:

venv/bin/pip install --editable .

Activate the local environment:

source venv/bin/activate

Method 4 - Developer, dependencies install only

Clone the project:

git clone https://github.com/kalliope-project/kalliope.git
cd kalliope

Install the python dependencies directly:

sudo pip install -r install/files/python_requirements.txt

Test your env

To ensure that you can record your voice, run the following command to capture audio input from your microphone:

rec test.wav

Press CTRL-C after capturing a sample of your voice.

Then play the recorded audio file

mplayer test.wav

Your installation is now complete, let's take a look now to the quickstart documentation to learn how to use Kalliope.

Get a starter configuration

We create some starter configuration that only need to be downloaded and then started. Those repositories provide you a basic structure to start playing with kalliope. We recommend you to clone one of them and then go to the next section.

If everything is ok, you can start playing with Kalliope. First, take a look to the default settings.