Set Up Jupyter Notebook for MATRIX Voice & MATRIX Creator

Required Hardware

Before getting started, let's review what you'll need.

• Raspberry Pi 3 or 4.
• MATRIX Voice or MATRIXCreator - Raspberry Pi does not have a built-in microphone, the MATRIX Voice&MATRIXCreator 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 and use the guides for Mac OS, Linux. and Windows on the Raspberry Pi website.
• 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/4 has built-in WiFi.

Let's Get Started

Jupyter Notebook is an open-source web app that allows live coding, data visualizing, equation-crunching, and document sharing.

This guide will show you how to install and setup a Jupyter Notebook server on your Raspberry Pi that will allow you to connect from your personal computer.

Install MATRIX Lite Python

We'll install the Python version of MATRIX Lite to program with the Jupyter Notebook:

https://matrix-io.github.io/matrix-documentation/matrix-lite/getting-started/python/

Installing Jupyter Notebook (Raspberry Pi)

On your Raspberry Pi, run the following commands to:

Install Jupyter Notebook dependencies.

sudo apt-get install python3-matplotlib python3-scipy

Install Jupyter Notebook.

sudo python3 -m pip install jupyter

Note: Jupyter Notebook requires >= Python3.6. The latest Raspbian has this version of Python by default. You will have to install >= Python3.6 for this to work on older Raspbian versions.

Starting Jupyter Notebook (Raspberry Pi)

With Jupyter Notebook now installed, it's time to try running it!

jupyter notebook --no-browser --port=8889

Be sure to save the token you receive. We need this to setup the password for our notebook at a later stage as shown below.

Connecting to Your Jupyter Notebook (Personal Computer)

In order to be able to access the Jupyter server on your Raspberry Pi, you'll need to bind the port to your computer.

ssh -N -L localhost:8888:localhost:8889 pi@YOU.PI.IP.ADDRESS.HERE

Once you input your Pi's login password, you'll notice that nothing is happening and that's okay! The Jupyter Notebook should now be accessible by visiting the following URL on your personal computer's browser: http://localhost:8888

Scroll down to "Setup a Password". Remember that token you received from starting the Jupyter Notebook server? Well, it's time to use it and set a password for your Notebook!

You're now ready to create programs with Jupyter Notebook! Create a new Python 3 notebook in the main menu to see how easy it is to program your MATRIX device.

Head over to our documentation to run examples and start coding!