Alexa Shopping List Companion

This is an extensible Alexa Companion Skill.

Prerequisites

1. You will need an Amazon Developer account as well as an AWS account

2. Clone the repository

3. Create AWS credentials

4. Install the Alexa Skill Kit

   npm i -g ask-cli
   

5. Configure the Alexa Skill Kit

   ask configure
   

   You will need to associate an AWS Profile with ASK CLI. When asked for access keys:

   1. Go to the IAM user list and click on the user you just created
   2. Click on the security credentials tab
   3. Scroll down to the access keys section and create a new key
   4. After finish, copy the access keys to ask cli

   If you have trouble getting it to work you can also try it by using your main aws account.

6. Set the correct region (i.e. region=eu-west-1)

   nano ~/.aws/credentials
   

7. Set up config

   Rename lambda/.env.sample to lambda/.env

   Fill in lambda/.env

   OR

   You may also set those in the AWS UI as "Environment Variables"

8. Update skill.json

   Rename skill-package/skill.sample.json to skill.json

9. Install dependencies

   cd lambda/
   

   npm i
   

Configuration

• API_URL: URL to your backend API (E.g. for HA: https://your-public-ha.domain/api)

• API_TOKEN: API token to authenticate against the API

• BACKEND: The backend to connect to. Supported: 'hass' and 'todo'

Deployment

New skill

1. Run

   ask deploy
   

Existing skill

1. Get the ARN of your lambda function and update skill-package/skill.json

   "apis": {
     "custom": {}
   },

   to

     "apis": {
       "custom": {
         "endpoint": {
           "uri": "arn:aws:lambda:..."
         }
       }
     },

2. Add the /.ask/ask-states.json you saved from your last deployment

3. Run

   ask deploy
   

Debugging

ask dialog --locale de-DE

Backend support

• Home Assistant Shopping List
• To-Do-List

Language support

• German