Installation

1. Register at Amazon

First you need to obtain a set of credentials from Amazon to use the Alexa Voice service. Make a note of these credentials as you will be asked for them during the install process.

• Login at https://developer.amazon.com and go to ALEXA, then Alexa Voice Service.
• Register a Product Type > Device.
• You are at Device Type Info left tab.
  • For the Device Type ID and Display Name use something like AlexaPi or whatever you want.
  • Next
• You are at Security Profile left tab.
  • From the drop-down menu choose Create a new profile.
  • Choose whatever for Security Profile Name and Security Profile Description. Hit Next.
  • Under Web Settings horizontal tab hit Edit and:
    • Allowed Origins - put there http://localhost:5050 and http://ALEXA.DEVICE.IP.ADDRESS:5050
    • Allowed Return URLs put http://localhost:5050/code and http://ALEXA.DEVICE.IP.ADDRESS:5050/code. You have to replace ALEXA.DEVICE.IP.ADDRESS with the IP (for example 192.168.1.123) of your AlexaPi device (for example Raspberry Pi). This is especially necessary when you are installing from another computer than AlexaPi is gonna run on.
• Fill some of the other stuff in.

2. Install AlexaPi

1. Boot your PC and login to a command prompt.

2. Make sure you are in /opt by issuing

   cd /opt
   

3. Make sure you have the bare minimum to use git and compile Debian OSs (Debian, Raspbian, OSMC, OpenElec...)

   sudo apt-get install git build-essentials
   

4. Clone this repo

   sudo git clone https://github.com/alexa-pi/AlexaPi.git
   

5. Run the setup script

   sudo ./AlexaPi/src/scripts/setup.sh
   

Follow instructions...

Enjoy :)

NOTE: You can also clone the repository to any other directory (and lose the sudo for the second command, if you have permission to write to that directory), but you won't be able to run AlexaPi on boot with our init scripts. It is therefore recommended for advanced users (who know what they're doing) only.