susi_installer | SUSI Installer for RPi and Linux Desktops

This repository provides installation packages for the SUSI.AI Personal Assistant, both for desktop installation as well as images for the SUSI.AI Smart Speaker based on Raspberry Pi.
If you want to get SUSI.AI Personal Assistant installed quickly without reading all the small print, here are two avenues you can select: Either use our pre-built images, or install using our scripts.
Run the following command (assuming you have curl installed):.
WARNING we strongly suggest using the method above. If you really want to use some different method, please see the various install scripts. Get the installer package SUSIAI-release-YYYYMMDD.S.tar.gz (or SUSIAI-build-YYYYMMDD.S.tar.gz) from the Github SUSI Installer release page. The package unpacks into a directory. which can be placed anywhere in your system. We generally recommend placing it into. but feel free to move it somewhere else. The SUSI.AI Smart Assistant depends on a lot of additional software that can be installed using the included script. For other options, please see below for details. If sudo is not an option, the following method can be used. This method is much less tested, because the required Python modules will be installed into your home directory (~/.local/lib). On the other hand, no sudo permissions are needed, and everything can be done as local user. There are several script to start, stop, and configure SUSI.AI available in .../SUSI.AI/bin, but this directory is usually not in your PATH environment variable. If you don't want to call the scripts always with full path, you can either add .../SUSI.AI/bin to your PATH. or link the scripts to one of the directories already in your PATH. where <SOME_DIR> is the place where the links are created. would make the SUSI.AI scripts available in ~/bin. You can add menu entries to your desktop environment by calling.
SUSI Server - starts the SUSI Server, a necessary component
SUSI.AI Personal Assistant - starts the privacy assistant in the background
SUSI.AI Personal Assistant - Application Window - an application that allows interaction via an GUI
SUSI.AI Personal Assistant - Configuration - configuration of various parameters of SUSI.AI
The provided script install-requirements checks that the above mentioned programs are available, checks the version number of the available pip3 binary, updating it if necessary using pip3 itself, and then uses pip3 to install the missing requirements. The script uses sudo to obtain root rights to install the necessary Python libraries.
The installaction script install-susi.sh carries out the actual installation on the target system. It checks that the above set of programs is availabe, clones the necessary git repositories from github, and installs Systemd unit files to allow starting/enabling the respective programs. On the Raspberry based SUSI.AI Smart Speaker, several further tasks are carried out to set up audio playback, sound device setup etc.
The installation can be carried out in either user moder or system mode:.
user mode: All files are installed into the directory SUSI.AI in the home directory of the current user (the location can be configured). Systemd unit files into the current user's systemd configuration directory. Utility programs for SUSI.AI are installed into SUSI.AI/bin.
system mode: All files are installed into the directory SUSI.AI in /usr/local (again, the location can be configured), and systemd unit files are installed in the system-wide systemd configuration directories. Utility programs for SUSI.AI are installed into /usr/local/bin. In system mode a new dedicated user for the SUSI.AI server process is necessary, and will be created. By default it will be named _susiserver.