No Description

nico bf7806fff3 8 years ago
Docs b279630619 8 years ago
Tests bf7806fff3 8 years ago
brains 448876ffa0 Merge pull request #85 from kalliope-project/fix_wikipedia_neuron 8 years ago
core f36cedb6c2 8 years ago
images aef85e0a68 8 years ago
install 2680d79be0 [Tests] add first raw of twitter neuron tests 8 years ago
neurons b8a0d1c999 [Tests] Fix Twitter wrong exception raises + test param twitter + wakeonlan neuron test on params 8 years ago
sounds e62d39e600 8 years ago
stt 69169d436e review dynamic load of classes 8 years ago
templates d4124b26d0 8 years ago
trigger 950c273848 [Doc] add setup 8 years ago
tts 69169d436e review dynamic load of classes 8 years ago
.gitignore b049dd38dc Split Cache & FileManager 8 years ago
.travis.yml f5885dab31 [Feature] Travis CI : add deb dependencies repos roll back 8 years ago
CHANGELOG.md 38a5000e6f 8 years ago
LICENSE.md a4dd9d2f16 8 years ago
README.md f5885dab31 [Feature] Travis CI : add deb dependencies repos roll back 8 years ago
brain.yml 9a79bb11af 8 years ago
kalliope.py a3fba4b533 8 years ago
manual_testing.py 4072e30e6b 8 years ago
settings.yml 60bac31e79 8 years ago
tasks.yml b73c5224b4 8 years ago

README.md

Kalliope

Build Status

logo

Kalliope is a modular always-on voice controlled personal assistant designed for home automation. Kalliope is based on audio input recognition, so it recognize an order pronounced by the user and then execute actions attached to the order.

You can create your own Kalliope bot, by simply choosing and composing the existing modules without writing any code. But, if you need a particular module, you can write it by yourself and add it to your project. You can also propose it to the community.

Kalliope can run on all Linux Debian based distribution including a Raspberry Pi and it's multi-lang. The only thing you need is a microphone.

Kalliope is easy-peasy to use, see the hello world

  - name: "Hello-world"
    signals:
      - order: "say hello"
    neurons:      
      - say:
          message: "Hello world!"    

Installation

Usage

Documentation summary

Link Detail
Settings The main Kalliope configuration
Brain What is the brain and how to create your own bot
neuron What is a neuron and how to use it
neuron list List of availlable neurons
CLI How to use Kalliope from the command line interface
Signals Signals are input event that can wake up kalliope (spoken order, scheduled event, REST API)
STT Speech to text configuration
TTS Text to speech configuration
Triggers Magic hotword engine used to make Kalliope listtening for an order
REST API Integrated REST API. Can be used to send an order

Contributing

If you'd like to contribute to Kalliope, please read our Contributing Guide, which contains the philosophies to preserve, tests to run, and more. Reading through this guide before writing any code is recommended.

Credits

Meaning of Kalliope Kalliope means "beautiful voice" from Greek καλλος (kallos) "beauty" and οψ (ops) "voice". In Greek mythology she was a goddess of epic poetry and eloquence, one of the nine Muses. PRONOUNCED: kə-LIE-ə-pee (English) PRONOUNCED: Ka-li-o-pé (French)

Links

Demo French : video

License

Copyright (c) 2016. All rights reserved.

Kalliope is covered by the MIT license, a permissive free software license that lets you do anything you want with the source code, as long as you provide back attribution and "don't hold you liable". For the full license text see the LICENSE.md file.