{"id":13776566,"url":"https://github.com/snipsco/snipsmanager","last_synced_at":"2025-05-11T10:31:09.246Z","repository":{"id":57468926,"uuid":"98403873","full_name":"snipsco/snipsmanager","owner":"snipsco","description":"The Snips Assistant Manager","archived":true,"fork":false,"pushed_at":"2018-04-30T14:16:12.000Z","size":38466,"stargazers_count":14,"open_issues_count":8,"forks_count":16,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-04-26T18:15:57.924Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snipsco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-26T09:14:46.000Z","updated_at":"2025-03-03T20:48:20.000Z","dependencies_parsed_at":"2022-09-26T16:50:30.757Z","dependency_job_id":null,"html_url":"https://github.com/snipsco/snipsmanager","commit_stats":null,"previous_names":["snipsco/snipsskills"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snipsco%2Fsnipsmanager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snipsco%2Fsnipsmanager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snipsco%2Fsnipsmanager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snipsco%2Fsnipsmanager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snipsco","download_url":"https://codeload.github.com/snipsco/snipsmanager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253551615,"owners_count":21926323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T18:00:29.123Z","updated_at":"2025-05-11T10:31:07.514Z","avatar_url":"https://github.com/snipsco.png","language":"Python","funding_links":[],"categories":["Tools"],"sub_categories":["Informational"],"readme":"# Snips Manager [❗️DEPRECATED]\n\n[![Build Status](https://travis-ci.org/snipsco/snipsmanager.svg)](https://travis-ci.org/snipsco/snipsmanager)\n[![PyPi](https://img.shields.io/pypi/v/snipsmanager.svg)](https://pypi.python.org/pypi/snipsmanager)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/snipsco/snipsmanager/master/LICENSE.txt)\n\n\u003e ❗️ The SnipsManager project is now deprecated. We now offer a more native way to run intents actions with the `snips-skills-server`.\n\u003e A migration guide can be found [here](https://snips.gitbook.io/tutorials/t/technical-guides/snipsmanager-migration-guide). \n\n## Notice of Deprecation\n\nAs of 30/04/2018, the `snipsmanager` project is now deprecated as the snips platform now offers a more native way to run skills **actions**. \nAll skills written with `snipsmanager` can easily be ported to the `snips-skills-server`. It is also possible to run `snipsmanager` within `snips-skills-server`. \n\nA migration guide can be found [here](https://snips.gitbook.io/tutorials/t/technical-guides/snipsmanager-migration-guide). \n\n\n## Introduction\n\nThe Snips Manager is a tool for easily setting up and managing a [Snips](https://www.snips.ai) assistant.\n\nA single configuration file, the [Snipsfile](https://github.com/snipsco/snipsmanager/wiki/The-Snipsfile), is required to create a Snips assistant. In it, you specify:\n\n- The URL of your assistant model, as created in the [Snips Console](https://console.snips.ai)\n- The [lambdas](https://github.com/snipsco/snipsmanager/wiki/Creating-a-Lambda) you want to install\n- Bindings between intents and lambdas\n- If required, additional parameters for your lambdas, such as an API key or the address of a lamp\n- Various configuration parameters, such as language and logging preferences.\n\nCheck out [Awesome Snips](https://github.com/snipsco/awesome-snips), a curated list of Snips assistants, lambdas and other resources to get you started.\n\n## Installation\n\n### Debian package\n\nSnips Manager is available as an `apt-get` package. To install it, run the following:\n\n```sh\n$ sudo apt-get update\n$ sudo apt-get install -y dirmngr\n$ sudo bash -c 'echo \"deb https://raspbian.snips.ai/$(lsb_release -cs) stable main\" \u003e /etc/apt/sources.list.d/snips.list'\n$ sudo apt-key adv --keyserver pgp.mit.edu --recv-keys D4F50CDCA10A2849\n$ sudo apt-get update\n$ sudo apt-get install -y snipsmanager\n```\n\n### Python package\n\nSnips Manager also comes as a `pip` package. This however requires installing a few dependencies beforehand. Start by running:\n\n```sh\n$ sudo apt-get update\n$ sudo apt-get install git python-pip libsdl-mixer1.2 libusb-1.0 \\\n    python-pyaudio libsdl1.2-dev cython cython3 libudev-dev \\\n    python-dev libsdl-image1.2-dev libsdl-mixer1.2-dev \\\n    libsdl-ttf2.0-dev libsmpeg-dev python-numpy libportmidi-dev \\\n    libswscale-dev libavformat-dev libavcodec-dev \\\n    portaudio19-dev nodejs build-essential -y\n```\n\nNext, create a Python virtual environment to avoid conflicts with existing dependencies, and to be able to run Snips Manager without root privileges:\n\n```sh\n$ sudo pip install --upgrade virtualenv\n$ virtualenv --python=/usr/bin/python2.7 snips\n$ source snips/bin/activate\n(snips) $ pip install pip --upgrade\n```\n\nYou may replace `snips` with any name for your virtual environment.\n\nWe are ready to install the `snipsmanager` package:\n\n```sh\n(snips) $ pip install snipsmanager\n```\n\n## macOS\n\nOn macOS, Snips Manager is also available as a `pip` package. To install, Portaudio, Pyaudio and SDL are needed:\n\n```sh\n$ sudo easy_install pip\n$ brew install portaudio\n$ brew install sdl\n$ pip install --global-option='build_ext' \\\n    --global-option='-I/usr/local/include' \\\n    --global-option='-L/usr/local/lib' pyaudio\n```\n\nNext, like with Raspbian, we create a Python virtual environment in which Snips Manager will be run:\n\n```sh\n$ sudo pip install --upgrade virtualenv\n$ virtualenv --python=/usr/bin/python2.7 snips\n$ source snips/bin/activate\n(snips) $ pip install pip --upgrade\n```\n\nSnips Manager can now be installed:\n\n```sh\n(snips) $ pip install snipsmanager\n```\n\n## Usage\n\n### Creating the Snipsfile\n\nStart your project by creating a `Snipsfile`, which is where all the configuration is set. This is a simple text file, adhering to the [YAML](https://en.wikipedia.org/wiki/YAML) format. Here is a basic configuration:\n\n```yaml\nassistant_url: \u003cYOUR ASSISTANT URL\u003e\ndefault_location: Paris,fr\nskills:\n  - package_name: snipshue\n    class_name: SnipsHue\n    url: https://github.com/snipsco/snips-skill-hue\n    params:\n      hostname: \u003cPHILIPS HUE IP\u003e\n      username: \u003cPHILIPS HUE USERNAME\u003e\n      light_ids: [1, 2, 3, 4, 5, 6]\n    intents:\n      - intent: ActivateLightColor\n        action: \"turn_on\"\n      - intent: DeactivateObject\n        action: \"turn_off\"\n```\n\nFor further explanations and examples, check out our [Snipsfile Wiki](https://github.com/snipsco/snipsmanager/wiki/The-Snipsfile).\n\n### Installing the lambdas\n\nNext, setup the assistant by running the `install` command:\n\n```sh\n$ snipsmanager install\n```\n\nThe `snipsmanager` service will automatically start on boot. You can also start it manually by running:\n\n```sh\n$ snipsmanager run\n```\n\n## Contributing\n\nPlease see the [Contribution Guidelines](https://github.com/snipsco/snipsmanager/blob/master/CONTRIBUTING.md).\n\n## Copyright\n\nThis library is provided by [Snips](https://www.snips.ai) as Open Source software. See [LICENSE.txt](https://github.com/snipsco/snipsmanager/blob/master/LICENSE.txt) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnipsco%2Fsnipsmanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnipsco%2Fsnipsmanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnipsco%2Fsnipsmanager/lists"}