Voice Assistant for Linux

Say hi to VAL (Voice Assistant for Linux)!

Description

A virtual assistant for Linux for controlling the operating system graphical user interface by using voice commands.

• Project task list status

  1. Human voice recognition.
  2. Human voice transcription.
  3. Detects voice commands from a defined list and executes it.
  4. Debug mode.
  5. Works on i3 tiling window manager.
  6. Works on Gnome desktop environment.
  7. Works on KDE Plasma desktop environment.
  8. Works on XFCE desktop environment.
  9. Infinite while loop should be implement.

• Warning

  1. The software run only at once. This should be fixed by implementing the infinity while loop. The problem here is to define a strategy to invoke only the voice command after the user say 'Val'. Furthermore the source code must be returned to wait the 'Val' to be called again.

Requirements

1. Linux kernel.
2. Python >= 3.10 (only because the match case and 'f' strings).
3. PIP3.
4. Shell Script Library.

For all Linux distributions

• Install Shell Script Library

  $curl -fsSL github.com/henrikbeck95/shell_script_library/releases/latest/download/shell-script-library -O

  $ mv ./shell-script-library /usr/local/bin/shell-script-library

For a specific Linux distribution

• ArchLinux

  $ sudo pacman -S festival festival-english festival-us python-pyaudio

Installation

Development mode

1. Install Python libraries

   $ pip3 install SpeechRecognition

   $ pip3 install yaml-1.3

   $ pip3 install setuptools

   $ pip3 install wheel

   $ pip3 install twine

   $ pip3 install voice-assistant-linux

2. Clone this repository.

   $ git clone https://github.com/henrikbeck95/voice_assistant_linux.git

3. Build the package for PyPi

   $ python3 setup.py sdist bdist_wheel

4. Upload the package to PyPi repository

   $ twine upload dist/*

Normal usage mode

1. Install from PyPi repository

   $ pip3 install voice-assistant-linux

Usage

Development mode

1. Run it.

   $ python3 ./src/__init__.py

Uninstallation

Development mode

• Remove the Val project folder

  $ rm -fr ./voice_assistant_linux/

Normal usage mode

1. Uninstall it.

   $ pip3 uninstall voice-assistant-linux