Skip to content

Derilion/icarus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Icarus

A project to create a modular digital assistant with voice support licensed under MIT License

Notice: This program is still very much under development. Everything is provided as is and will probably change a lot by later versions.

Installation

Setting up a Python virtual environment as described here is strongly recommended. Only tested for Python >= 3.8. Windows is currently not supported for the speech client, will come back soon

  1. Clone the repository to a place of your liking
  2. Install pyaudio manually for your system as described here
    • Windows needs to install pyaudio using winpip
          pip install pipwin
          pipwin install pyaudio
    • OSX needs to install pyaudio using brew
          brew install portaudio
          pip install pyaudio
  3. Install requirements from requirements.txt pip install -r requirements.txt
  4. Set up given tokens and configurations in your configuration directory, e.g. \AppData\Local\derilion\icarus\settings.ini on Windows or $HOME/.config/icarus_base/settings.ini in linux
  5. Run python main.py

Usage

For general usage a given text or speech input will be processed and a response will be given on the same channel. By default a command line client is included and can respond to text queries based on the installed skills.

The currently only supported hotword to activate voice interaction is 'Jarvis'.

Installation of Skills

Skill files need to be copied to the icarus/skills/ directory. When Icarus is restarted it will automatically recognize skills and enable them.

Installation of Clients

Client files need to be copied to the icarus/Clients/ directory. When Icarus is restarted it will automatically recognize clients and enable them.

How to write new Skills

For Skills a straightforward API is given via inheritance. Inherit from icarus.skills.superclient.SuperClient, set values for self.id and the skill can be loaded.

General parameters which should be set are:

  • self.id: unique id
  • self.name: skill name shown in userspace
  • self.version: version revision of the skill
  • self.creator: credit to yourself (and to blame you ofc)
  • self.phrases: array of example sentences used to recognize if a phrase should be mapped to your skill

Functions you should implement are:

  • def setup(self): Function is loaded before the skill is used, use to set up skill tokens etc.
  • def main(self, message): Function is called if a new message has been received and given to the skill. A Context object will be given, which offers message information in Context.msg and the option to respond in text via Context.send(str)

Configuration data can be loaded using self.get_config('ID_HERE'). A dictionary can be saved between program runs using self.save_dict(DICTIONARY) and later be loaded using self.load_dict(DICTIONARY)

Releases

No releases published

Packages

No packages published

Languages