Kalliope is a modular always-on voice controlled personal assistant designed for home automation.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
Nicolas Marcq b1e58f2d1e Merge pull request #312 from jpeters/patch-1 5 years ago
Docs Updated raspbian_jessie.md 5 years ago
Tests add overrriding parameters when using run a synapse by name in API 5 years ago
brain_examples [Review] Refacto, tests, typos 5 years ago
docker add grammar to cmusphinx STT (#304) 5 years ago
images led and mute button support for Rpi 5 years ago
install add grammar to cmusphinx STT (#304) 5 years ago
kalliope v0.4.5 release 5 years ago
.gitignore Split Cache & FileManager 6 years ago
.travis.yml Use Python 3.4 5 years ago
CHANGELOG.md v0.4.5 release 5 years ago
LICENSE.md rename project in docs and installation scripts 6 years ago
MANIFEST.in Doc review + cleanup 6 years ago
README.md fix travis badge + add beerpay badge 5 years ago
kalliope.py Add a valid development entry point kalliope.py at the root of the project. 6 years ago
setup.py add grammar to cmusphinx STT (#304) 5 years ago



Build Status Coverage Status Gitter PyPI version PyPI Beerpay

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"
      - order: "say hello"
      - say:
          message: "Hello world!"    


Quick start

Once installed, you can start learning basics of Kalliope from a quick start configuration


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 available 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 listening for an order
REST API Integrated REST API. Can be used to send an order
Players Player is the software used to make kalliope talk


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.

You liked kalliope? Star us!


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.

kə-LIE-ə-pee (English) Ka-li-o-pé (French) каллиопа (Russian)

Improve models with Snowboy

Demo French : video Demo English : video Android app : Playstore


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.