Skip to content
SUSI installer for RPi and linux desktop
Shell Python HTML JavaScript CSS Awk
Branch: development
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.buildkite Try to guess Pull Request ID from Git commit message (#428) Dec 13, 2018
.github Fix syntax in GitHub templates (#444) Dec 29, 2018
.travis fix unbound variable breaking build Sep 1, 2019
docs update configuration guide: configure via webclient Aug 5, 2019
pythonmods convert susi_config to loadable library, use a shell wrapper Aug 25, 2019
raspi unlink device Aug 31, 2019
scripts convert susi_config to loadable library, use a shell wrapper Aug 25, 2019
tests Added Snowboy Hotword detection with other improvements (#46) Jul 24, 2017
.travis.yml remove also 18.10, no precompiled pyalsaaudio available Jul 22, 2019
LICENSE Initial commit Apr 16, 2017 Fix link that was a 404 before Aug 29, 2019
TODO travis building of debian stretch&buster, ubuntu 18.04&19.04 May 16, 2019 Add local anonymous user Sep 1, 2019
requirements.txt make soundcloud_lib an optional dependency Aug 12, 2019 Configured SUSI to run on startup with sound animations (#313) Aug 15, 2018

SUSI.AI Installer

Codacy Badge Build Status Join the chat at Twitter Follow

SUSI AI on Desktop Linux and Raspberry Pi

This projects aims at installing the various components of SUSI.AI in your Raspberry Pi and Linux Distribution. It will enable you to bring Susi AI intelligence to all devices you may think like a Speaker, Car, Personal Desktop etc.

Minimum Requirements

For making a smart speaker

  • A hardware device capable to run Linux. Currently on Raspberry Pi 3 is supported. Other embedded computers, like BeagleBone Black, Orange Pi, will be supported in the future.
  • A Debian based Linux Distribution. Tested on
    • Raspbian on Raspberry Pi 3
  • A microphone for input. Currently the development team is using ReSpeaker 2-Mics Pi HAT for Raspberry Pi.
  • A speaker for output. On development boards like Raspberry Pi, you can use a portable speaker that connects through 3.5mm audio jack. If you are using ReSpeaker 2-Mics Pi HAT, the speaker should be plugged to this board.

For using SUSI.AI on your desktop

  • A desktop with any of the following linux distribution :
    • Ubuntu 18.04 or above
    • Debian stretch or above
    • Linux Mint 18.3
  • A microphone for input

Smart speaker assembly tutorial

How to assembly a smart speaker: Video

Installation Guide

Configuring Smart Speaker

  • Power on the device
  • Connect your computer or mobile phone to the SUSI.AI hotspot using the password "password".
  • Open which will show you the set-up page as visible below: SUSI.AI Wifi Setup
  • Put in your Wifi credentials. For an open network set an empty password. If The device should connect automatically to any open network, leave SSID and password empty.
  • Click on "Reboot Smart Speaker"
  • Wait for re-boot of the speaker, SUSI will say "SUSI has started" as soon it is ready.
  • If you want to return to the installation process (i.e. to configure another network), you can reset the device by pushing and holding the button for at least 10 seconds.

Configuring the Smart Speaker through the Android App

  • Download the SUSI.AI android app: Download Here
  • After Running the installation script , you'll have a RasPi in access point mode. With a Flask Server running at port 5000.
  • You can use the mobile clients to configure the device automatically.

Update Daemon

At any point of time, we may want to check if the current version of susi linux is updated. Hence we compare against the corresponding remote repository and we update it accordingly every time the raspberry Pi has started. Use the following commands.

  • cd update_daemon/
  • ./

Factory Reset

To initiate the factory reset.
Press and hold the button on the Respeaker HAT to perform the following functions

Button Press Duration Action Description
7-15 seconds(first beep) Access Point Mode Smart Speaker is set to access point mode: Use this for setting up wifi again
15-25 seconds(second beep) Soft Factory Reset Factory reset the device : User configuration is preserved
>25 seconds(third beep) Hard Factory Reset Factory reset the device : User configuration is not preserved
You can’t perform that action at this time.