AssistantPi is basically a tweak of AlexaPi allowing you to run Google Assistant and Amazon's Alexa on a Raspberry Pi. It includes the Google Assistant SDK and uses AlexaPi's hotword recognition to activate either Assistant or Alexa. The installer provides an easy way to get everything set up in just under an hour.
This is just an experimental proof-of-concept without broad support.
Credits / Further Resources:
- AlexaPi on Github
- AlexaPi Installation Guide
- Google Assistant SDK on Github
- Google Assistant SDK Getting Started Guide
You will need:
- A Raspberry Pi and an SD Card with a fresh install of Raspbian Jessie Lite
- Audio peripherals:
- external speaker with 3.5mm Jack
- USB microphone
- Have your Raspberry Pi running Raspbian ready and connected to the Internet. Use a fresh install of Raspbian Jessie Lite without Pixel.
- Follow this Google Guide and place the Google Assistant Credentials JSON in
- Prepare Amazon AVS Credentials as described in Step 1 of AlexaPi Installation Guide, you'll need them during Installation. Even if you only want Google Assistant, this has to be done for AlexaPi to work properly.
- Connect your audio peripherals (i.e. USB-Mic and Speaker via Jack).
- Clone this repository to
/optdirectory and rename the folder to AlexaPi (both important, it will fail otherwise). These commands will do that for you:
cd /opt sudo git clone https://github.com/xtools-at/AssistantPi.git AlexaPi
- Run the setup and go through all the steps. This will take a while, approx. 35min with a somewhat good Internet connection.
- If Authentication with Google Assistant API fails during setup, try to run it manually using
sudo bash /opt/AlexaPi/src/scripts/auth_assistant.sh
- If Google Assistant setup crashes, do what the Error message says and restart with
sudo bash /opt/AlexaPi/src/scripts/install_assistant.sh
- Check your audio setup. The installer puts the default config files in place, which should work for most people. Nevertheless, you might have to tweak them. You can skip this step and come back if you're running into any kind of trouble.
- Read through Step 3 of AlexaPi Installation Guide.
- Make sure to check Configure Google Assistant Audio too. The config files are already in place for you (
/var/lib/AlexaPi/.asoundrcfor the bootup-service - change both if necessary), but you might have to adjust the card- and device-ids according to the output of
aplay -l && arecord -lon your Pi.
- Start AssistantPi:
- If you've selected run on boot, reboot your Pi or run
sudo systemctl start AlexaPi.service.
- If not running on boot, start the script with
- If you've selected run on boot, reboot your Pi or run
- Trigger Assistant and Alexa with the hotwords Google and Alexa.
Bringing your AssistantPi up-to-date is just one command away:
sudo bash /opt/AlexaPi/src/scripts/update.sh
This updates both AssistantPi and the tweaked Assistant SDK without having you to go through the installation process again.
Important Notice: If installed before May 13th 2017 for the first time, please run the setup again after the update and do the Authentication with both Google and Amazon again.
To start AssistantPi in debugging mode, stop the service (if running) and run the script with the
sudo systemctl stop AlexaPi.service python /opt/AlexaPi/src/main.py -d
To start the embedded Google Assistant SDK, run
/opt/AlexaPi/env/bin/python -m googlesamples.assistant --credentials /etc/opt/AlexaPi/assistant_credentials.json # same as running ### source /opt/AlexaPi/env/bin/activate ### python -m googlesamples.assistant --credentials /etc/opt/AlexaPi/assistant_credentials.json
and type assistant_record into the prompt to start a conversation. For more information on Assistant Troubleshooting, check here.
The base audio config is done for you in the setup for both AlexaPi and Assistant. However, if encountering any audio issues in playback or recording, make sure to check by here:
If Google Assistant audio output is choppy or truncated, check the following. Make sure to run
source /opt/AlexaPi/env/bin/activate before running the samples there, to target AssistantPi's Python environment.
You can set the values for the Block- and Flush size in the AssistantPi config, either before Installation in
/opt/AlexaPi/src/config.template.yaml or afterwards in
/etc/opt/AlexaPi/config.yaml. Go find the attribute
sound > assistant and use your values for
Make sure you've been to
sudo raspi-config, Advanced Options > Audio and have set the desired audio output (i.e. 3.5mm Jack, not HDMI).
To change the hotwords (currently Alexa and Google), either change both these files before running the setup:
.../src/config.template.yaml (phrase and phrase_assistant) and
/opt/AlexaPi/src/keyphrase.list after setup.
config.yaml, you may use a single String or an Array of Strings for your phrase_assistant (only). Every string there will trigger Assistant, everything else in your
keyphrase.list will trigger Alexa.
keyphrase.list, you can also tweak the sensitivity of the hotword recognition. From the CMUSphinx Wiki:
Threshold must be tuned for every keyphrase on a test data to get the right balance missed detections and false alarms. You can try values like 1e-5 to 1e-50. For the best accuracy it is better to have keyphrase with 3-4 syllables. Too short phrases are easily confused.
You can also combine wakewords, e.g. "ok google" and/or "hey google". Also make sure that your new hotwords are included in the language model. Check the following directory for a file with
.dic extension and add your hotwords if not already there:
Change Hotword language
The default language coming with Pocketsphinx for the hotword recognition is US English. If you want to change it (which might be necessary if your hotwords aren't recognized well), head over to CMUSphinx Downloads page and get the model files for your language. In particular, you have to place the following files
/usr/local/lib/python2.7/dist-packages/pocketsphinx/model/ and the contents of
/usr/local/lib/python2.7/dist-packages/pocketsphinx/model/[lng-lng] (where [lng-lng] is the language code of your imported language, e.g. 'de-de')
Make sure, that
FILENAME.dic contains your desired hotwords (i.e. Alexa and Google for default settings), if not, add them.
- change language to your language code (e.g. 'de-de', see above)
- change dictionary to your FILENAME.dic (e.g. 'cmusphinx-voxforge-de.dic')
Install German language package
- Download package from here and unzip, move contents to
cd /home/pi/Downloads wget http://dl.xtools.at/pocketsphinx-german.zip sudo unzip pocketsphinx-german.zip -d /usr/local/lib/python2.7/dist-packages/pocketsphinx/model/
- Edit your config.yaml and include new values
sudo nano /etc/opt/AlexaPi.config.yaml # find pocketsphinx > language, change to 'de-de' # find pocketsphinx > dictionary, change to 'cmusphinx-voxforge-de.dic'