A neuron is a module that will perform some actions attached to an order. You can use it in your synapses. See the complete neuron documentation for more information.
Name | Description |
---|---|
ansible_playbook | Run an ansible playbook |
kill_switch | Stop Kalliope process |
neurotransmitter | Link synapse together |
say | Make Kalliope talk by using TTS |
script | Run an executable script |
shell | Run a shell command |
sleep | Make Kalliope sleep for a while before continuing |
systemdate | Give the local system date and time |
uri | Interacts with HTTP and HTTPS web services. |
Name | Description |
---|---|
Post and Read message on Facebook | |
gmail_checker | Get the number of unread email and their subjects from a gmail account |
google agenda | Get your next meetings on google calendar |
google maps | Get address / distance / time / directions from Google maps |
hue | Control the Philips Hue lighting system |
list available orders | Let kalliope tell you what she how she can help |
MPD | Play music via an MPD server |
openweathermap | Get the weather of a location |
pi camera | Take picture with your picamera |
pushetta | Send a push message to a remote device like Android/iOS/Windows Phone or Chrome browser |
repeat | Make kalliope say whatever you want |
rss_reader | Get rss feed from website |
slack | Post and Read message on Slack |
system_status | Get info about the system (cpu, memory, … |
tasker | Send a message to Android tasker app |
todotxt | Manage a todolist via Kalliope |
Send a Twit from kalliope | |
wake_on_lan | Wake on lan a computer |
web scraper | Read web pages that don't provide RSS feed or APIs (by scraping html) |
wikipedia | Search for a page on Wikipedia |
Wanna add your neuron in the list? Open an issue with the link of your neuron or send a pull request to update the list directly.
To know how to install a community neuron, read the "Installation" section of the neuron documentation.
Core neurons are already packaged with the installation of kalliope an can be used out of the box. Community neuron need to be installed manually.
Note: To install a neuron, you must declare your
resource_directory
in your settings.
CLI syntax
kalliope install --git-url <git_url>
E.g:
kalliope install --git-url https://github.com/kalliope-project/kalliope_neuron_wikipedia.git
You may be prompted to type your sudo
password during the process.
You can also install a neuron manually. Fist, clone the repo in the right resource folder.
cd /path/to/resource_folder
git clone <plugin_url>
Then install it manually via Ansible (Ansible has been installed with kalliope)
cd <cloned_repo>
ansible-playbook install.yml -K
Full example
cd /home/me/my_kalliope_config/resources/neurons
git clone https://github.com/kalliope-project/kalliope_neuron_hue.git
cd hue
ansible-playbook install.yml -K
Note: To uninstall a resource, you must declare the
resource_directory
in your settings.
CLI syntax
kalliope uninstall --neuron-name <neuron_name>
kalliope uninstall --stt-name <stt_name>
kalliope uninstall --tts-name <tts_name>
kalliope uninstall --trigger-name <trigger_name>
E.g:
kalliope uninstall --neuron-name hue
To remove a resource, you only need to delete the folder from the corresponding resource_directory
.
cd /path/to/resource_folder
rm -rf <resource_name>
E.g
cd /home/me/my_kalliope_config/resources/neurons
rm -rf hue
Note: When deleting a resource folder, libraries that have been installed by the resource are not removed from the system. If you want a complete cleanup, you'll have to open the install.yml file of the resource to see what have been installed and rollback manually each task. For example, when installing the neuron hue, the python lib called phue has been installed. To perform a complete cleanup, you need then to run "sudo pip uninstall phue".
To update a resource, you can either:
git pull