snipsmanager 0.1.6.29

Snips Skills Manager

Snips Manager

The Snips Manager Manager is a tool for easily setting up and managing a Snips assistant.

A single configuration file, the Snipsfile, is required to create a Snips assistant. In it, you specify:

• The URL of your assistant, as created in the Snips Console

• The skills you want to install

• Bindings between intents and skills

• If required, additional parameters for you skill, such as an API key or the address of a lamp

• Various configuration parameters, such as language and logging preferences.

Check out Awesome Snips, a curated list of Snips skills, assistants and other resources to get you started. In particular, make sure to read the Getting Started guide.

Installation

Raspbian

Snips Manager is available as an apt-get package. To install it, first add the Snips repository to your list of apt-get sources. In the folder /etc/apt/sources.list.d, create a file called snips.list, and add the line:

deb https://s3.amazonaws.com/snips-deb/ stable main

Then run:

$ sudo apt-get update
$ sudo apt-get install snipsmanager

macOS

Snips Manager is available on macOS via Homebrew. To install it, simply run:

$ brew install snipsmanager

Usage

Creating the Snipsfile

Start your project by creating a Snipsfile, which is where all the configuration is set. This is a simple text file, adhering to the YAML format. Here is a basic configuration:

assistant_url: <YOUR ASSISTANT URL>
locale: en_US
logging: True
default_location: Paris,fr
skills:
  - package_name: snipshue
    class_name: SnipsHue
    url: https://github.com/snipsco/snips-skill-hue
    params:
      hostname: <PHILIPS HUE IP>
      username: <PHILIPS HUE USERNAME>
      light_ids: [1, 2, 3, 4, 5, 6]
    intents:
      - intent: ActivateLightColor
        action: "turn_on"
      - intent: DeactivateObject
        action: "turn_off"

For further explanations and examples, check out our Snipsfile Wiki.

Installing the skills

Next, setup the system by running the install command:

$ snipsmanager install

Launching the skills server

If you enabled Snips Manager to run on boot, simply reboot your device. Otherwise, start the service manually by running:

$ snipsmanager run

Contributing

Please see the Contribution Guidelines.

Copyright

This skill is provided by Snips as Open Source software. See LICENSE.txt for more information.