SnipsKit
SnipsKit is a Python library with some helper tools to work with the voice assistant Snips. This can be used by Snips apps or other programs that work with Snips.
With SnipsKit, you can create Snips apps without having to write much boilerplate code. The simplest example of an app using SnipsKit is the following:
from snipskit.hermes.apps import HermesSnipsApp
from snipskit.hermes.decorators import intent
class SimpleSnipsApp(HermesSnipsApp):
@intent('User:ExampleIntent')
def example_intent(self, hermes, intent_message):
hermes.publish_end_session(intent_message.session_id,
"I received ExampleIntent")
if __name__ == "__main__":
SimpleSnipsApp()And that's it! No need to connect to an MQTT broker, no need to register callbacks, because the HermesSnipsApp class:
- reads the MQTT connection settings from the snips.toml file;
- connects to the MQTT broker;
- registers the method with the intent decorator as a callback method for the intent 'User:ExampleIntent';
- starts the event loop.
SnipsKit also has decorators for other events, and there's also a class MQTTSnipsApp to listen to MQTT topics directly. Moreover, SnipsKit also gives the app easy access to:
- the Snips configuration;
- the Hermes or MQTT connection object;
- the assistant's configuration;
- the app's configuration.
Warning
SnipsKit is currently alpha software. Anything may change at any time. The public API should not be considered stable.
Note
This project is not in any way affiliated to the company Snips.
System requirements
SnipsKit is a Python 3-only library, requiring Python 3.5 or higher. It's currently tested on Python 3.5, 3.6 and 3.7.
Installation
SnipsKit is packaged on PyPI. The latest stable version with all functionality can be installed with the following command:
pip3 install snipskit[hermes,mqtt]Documentation
The full documentation can be found on Read the Docs, for both the stable version and the development version.
Copyright
This library is provided by Koen Vervloesem as open source software. See LICENSE for more information.