|
@@ -1,125 +1,28 @@
|
|
|
-# Kalliope installation on Debian Jessie
|
|
|
+# Kalliope requirements for Debian Jessie
|
|
|
|
|
|
-## Requirements
|
|
|
+## Debian packages requirements
|
|
|
|
|
|
-### Debian packages requirements
|
|
|
-
|
|
|
-Edit `/etc/apt/sources.list` and check that you have `contrib` and `non-free` and backports archives enabled:
|
|
|
+Edit `/etc/apt/sources.list` and check that you have `contrib` and `non-free` are enabled:
|
|
|
```
|
|
|
deb http://httpredir.debian.org/debian jessie main contrib non-free
|
|
|
deb-src http://httpredir.debian.org/debian jessie main contrib non-free
|
|
|
-deb http://httpredir.debian.org/debian jessie-backports main contrib non-free
|
|
|
-deb-src http://httpredir.debian.org/debian jessie-backports main contrib non-free
|
|
|
```
|
|
|
|
|
|
Install some required system libraries and softwares:
|
|
|
|
|
|
```
|
|
|
sudo apt-get update
|
|
|
-sudo apt-get install git python-pip python-dev libsmpeg0 libttspico-utils libsmpeg0 flac dialog libffi-dev libffi-dev libssl-dev portaudio19-dev build-essential libssl-dev libffi-dev sox libatlas3-base mplayer
|
|
|
-```
|
|
|
-
|
|
|
-You also need some packages from the backports:
|
|
|
-
|
|
|
-```
|
|
|
-sudo apt-get install -t jessie-backports python-setuptools
|
|
|
-sudo apt-get install -t jessie-backports python-pyasn1
|
|
|
-```
|
|
|
-
|
|
|
-## Installation
|
|
|
-
|
|
|
-### Method 1 - User install using the PIP package
|
|
|
-
|
|
|
-You can install kalliope on your system:
|
|
|
-```
|
|
|
-sudo pip install kalliope
|
|
|
-```
|
|
|
-
|
|
|
-Or just in your user home:
|
|
|
-```
|
|
|
-pip install --user kalliope
|
|
|
-```
|
|
|
-
|
|
|
-Run Kalliope from a shell:
|
|
|
-```
|
|
|
-kalliope start
|
|
|
-```
|
|
|
-
|
|
|
-### Method 2 - Manual user install using the git repository
|
|
|
-
|
|
|
-Clone the project:
|
|
|
-```
|
|
|
-git clone https://github.com/kalliope-project/kalliope.git
|
|
|
-```
|
|
|
-
|
|
|
-Install the project:
|
|
|
-```
|
|
|
-sudo python setup.py install
|
|
|
-```
|
|
|
-
|
|
|
-Run Kalliope from a shell:
|
|
|
-```
|
|
|
-kalliope start
|
|
|
-```
|
|
|
-
|
|
|
-### 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
|
|
|
+sudo apt-get install git python-dev libsmpeg0 libttspico-utils libsmpeg0 flac dialog libffi-dev libffi-dev libssl-dev portaudio19-dev build-essential libssl-dev libffi-dev sox libatlas3-base mplayer
|
|
|
```
|
|
|
|
|
|
-Install the project using the local environment:
|
|
|
+Let's install the last release of python-pip
|
|
|
```
|
|
|
-venv/bin/pip install --editable .
|
|
|
-```
|
|
|
-
|
|
|
-Run Kalliope from a shell:
|
|
|
+wget https://bootstrap.pypa.io/get-pip.py
|
|
|
+sudo python get-pip.py
|
|
|
```
|
|
|
-venv/bin/kalliope start
|
|
|
-```
|
|
|
-
|
|
|
-### 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/python_requirements.txt
|
|
|
-```
|
|
|
-
|
|
|
-Run Kalliope from a shell directly:
|
|
|
-```
|
|
|
-python kalliope.py start
|
|
|
-```
|
|
|
-
|
|
|
-## 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
|
|
|
+Then, with pip, the last release of setuptools
|
|
|
```
|
|
|
-mplayer test.wav
|
|
|
+sudo pip install -U pip setuptools
|
|
|
```
|
|
|
|
|
|
-If everything is ok, you can start playing with Kalliope. First, take a look to the [default settings](../settings.md).
|