Skip to content

An intelligent Easy Assistant is a cutting-edge technology designed to simplify our daily routines and provide an enhanced level of convenience and comfort in our homes.

License

Notifications You must be signed in to change notification settings

astrixgame/easyassistant

Repository files navigation

Not fully functional yet

Now it supports only Loxone Miniserver
In the future it will have more connection with hubs.

About us

Easy Assistant is software designed to make life easier. Featuring voice recognition technology, the intelligent Easy Assistant responds instantly to voice commands, such as turning lights on or off, adjusting thermostat settings. It can detect your presence, and automatically adjust the temperature, lighting and other settings to create a comfortable environment while also conserving energy.

The assistant must be connected to the main controller like Loxone or other hub that we support.

The voice controling is running on the Jaro Winkler Distance Algorithm which means that the voice command can perform actions when the sentence is not corrent said or when the name of control is not said full and the Speech Recognition (ASR) is currently running os Vosk from Alphacephei

Features

  • Custom Interface with weather
  • Voice control
  • Simple to use
  • Support HW hubs

Getting started

You need port 80 free because the web intreface running on it
  1. Download the latest release from: https://github.com/astrixgame/easyassistant/releases or you can download it manually from git:
    git clone https://github.com/astrixgame/easyassistant.git
  2. Configure the server
    {                                              
          "hub": {                                   
              "type": "loxone",                      <-- Name of hub like loxone or other supported hubs
              "address": "Address:Port",             <-- Address and port of your hub
              "user": "Username",                    <-- Login Username of your hub
              "password": "SuperSecretPassword",     <-- Login Password of your hub
              "controlNameAlias": {                  
                  "uuid1": "alias name 1",           <-- If your control named like bulb and you want to tell light bulb you can change this
                  "uuid2": "alias name 2"            
              },
              "controlIgnore": [
                  "uuid1",                           <-- Ignored controls that will not show up in the interface and cannot be controlled by voice
                  "uuid2"
              ],
              "removedWordFromName": [
                  "name1",                           <-- If some control named like heat thermostat you can remove the word heat from name by adding it there but it will be removed from all controls of your hub
                  "name2"
              ]
          },                                         
          "language": "en-us",                       <-- Language of the interface and the voice
          "weather": {                               
              "from": "hub",                         <-- Where the weather be taken from hub for hub or openweather
              "openWeatherToken": ""                 <-- If in the row up below filled up with openweather fill this with openweather token
          },                                         
          "voiceActivateSentences": "hey"            <-- Activation sentence can be everything and you can add more than one separated by comma for example it will be there hey ... or only hey
          }
  3. Run the server by starting script that have name of your OS and 64 bits ...
    or run the server manually: node . or node server.js
  4. Test it by simply openning your server address and if everything works it will show and interface filled with controls panels of your hub
  5. (Optional) Install the client-app for voice controling you can select between many types and version of it, so for example if you want only voice recognition background app you can install from Releases voice_server app, but there are many types of client some of that will include interface and more features.
  6. (Optional) Only if you want to use voice control
    You can download voice model from https://alphacephei.com/vosk/models
    It will download as modelname.zip then copy it into server models folder withnout unzipping it but rename it to your language name like en-us

License

Apache

About

An intelligent Easy Assistant is a cutting-edge technology designed to simplify our daily routines and provide an enhanced level of convenience and comfort in our homes.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published