snipsskills 0.1.6.13

Snips Skills Manager

Snips Skills Manager

The Snips Skills 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 Skills 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 snipsskills

macOS

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

$ brew install snipsskills

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:

$ snipsskills install

Launching the skills server

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

$ snipsskills run

Contributing

Please see the Contribution Guidelines.

Copyright

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