Software apps and online services
Before get started, let's review what you'll need.
- Raspberry Pi 3 (Recommended) or Pi 2 Model B (Supported).
- MATRIX Voice OR MATRIX Creator - Raspberry Pi does not have a built-in microphone, the MATRIX Voice & MATRIX Creator each have an 8 mic array - Buy MATRIX Voice or Buy MATRIX Creator.
- Micro-USB power adapter for Raspberry Pi.
- Micro SD Card (Minimum 8 GB) - An operating system is required to get started. You can download Raspbian Stretch and use the guides for Mac OS, Linux and Windows in the Raspberry Pi website.
- External Speaker with 3.5 mm audio cable.
- A USB Keyboard & Mouse, and an external HDMI Monitor - we also recommend having a USB keyboard and mouse as well as an HDMI monitor handy. You can also use the Raspberry Pi remotely, see this guide from Google.
- Internet connection (Ethernet or WiFi)
- (Optional) WiFi Wireless Adapter for Pi 2. Note: Pi 3 has built-in WiFi.
Once you have the Raspberry Pi with the SD Card inserted, the MATRIX Voice connected to it, power up the Raspberry Pi and open a terminal either in the Raspbian Desktop or just by ssh into it ( if you are you are using the Raspbian Lite version, in this case see guide on how to ssh here).1. Installing MATRIX software
In order to allow the Google Assistant software to have access to MATRIX Voice microphones, run the following in your Raspberry Pi's terminal:
Add the MATRIX repository and key.
curl https://apt.matrix.one/doc/apt-key.gpg | sudo apt-key add - echo "deb https://apt.matrix.one/raspbian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/matrixlabs.list
Update your packages.
sudo apt-get update sudo apt-get upgrade
Install the MATRIX packages.
sudo apt install matrixio-creator-init
Reboot your device.
After rebooting, install the kernel modules.
sudo apt install matrixio-kernel-modules
Reboot your device for a second time.
2. Set up Google Assistant
In this step you will setup all the required software to finally run the Assistant. Make sure you are in the /home/pi directory before starting.
Follow the guides in the links below :
- Configure Google Developer Project
- Register the Device Model
- Install the Google Assistant SDK and Sample Code
Install git on your Raspberry Pi if you don't already have it.
sudo apt-get install git
Download our MATRIX Google Assistant repository.
4. Run the Google Assistant!
git clone https://github.com/matrix-io/google-assistant-matrixio.git cd google-assistant-matrixio/
Now you are ready. Just run the following line making sure you put your project id and device model id from previous steps:
~/google-assistant-matrixio/google-matrixio-assistant-hotword --project_id your-dev-project-id --device_model_id your-model-id
The output should be like this:
(Ignore the "Cloud discovery ..." errors, this is an open issue of the google assistant sdk that will be removed in next releases):
(env) pi@raspberrypi:~ $ ~/google-assistant-matrixio/google-matrixio-assistant-hotword --project_id your-dev-project-id --device_model_id your-model-id device_model_id: your-model-id device_id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX https://embeddedassistant.googleapis.com/v1alpha2/projects/your-dev-project-id/devices/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 403 [3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed:  Peer certificate cannot be authenticated with given CA certificates [3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed:  Peer certificate cannot be authenticated with given CA certificates EventType.ON_MUTED_CHANGED EventType.ON_START_FINISHED [3140:3159:ERROR:assistant_nupnp_client.cc(103)] Cloud discovery nupnp request failed:  Peer certificate cannot be authenticated with given CA certificates
Now you can talk to the Assistant starting with "OK Google" or just "Hey Google!"