Practical overview
When it fits
Use Kalliope when you want to define an assistant around event-to-action flows, especially for voice interaction or home automation on Debian-based Linux.
Who it is for
- People building a voice-controlled personal assistant on Debian-based Linux.
- Home automation builders who want spoken or event-based triggers to run modular actions.
- Developers who want to compose existing neurons or create custom assistant modules.
Documented uses
- Connect a spoken order to one or more assistant actions.
- Trigger actions from scheduled events, MQTT messages or GPIO events.
- Assemble an assistant from existing neurons without writing code.
- Write and add a custom neuron for a specialized task.
Requirements & limits
The project is open source under the GPL-3.0 license.
- Voice interaction requires a microphone, according to the project README.
- The project says it runs on Debian-based Linux distributions, including Raspberry Pi.
- Existing neurons can be composed without code; specialized functionality can be added by writing a neuron.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Use a starter kit to start a Kalliope assistant
Follow a starter kit’s existing configuration and brain examples to start Kalliope.
Before you start
- Follow Kalliope’s installation documentation.
- Have the starter kit repository URL.
Steps
Clone the starter kit repository with the command below.
git cloneChange into the cloned starter kit directory with
cd cloned_starter_kit.Start Kalliope with
kalliope start.
Expected outcome
Kalliope starts using the starter kit’s configuration and brain examples.
Guide limitations
- Starter kits provide configurations and examples for particular languages; the documented page lists Czech, English, French, German, and Italian.
- The starter kit instructions require Kalliope to be installed first.
Define a simple voice-order-to-neuron mapping
Configure an example mapping from the vocal order “say hello” to Kalliope’s say neuron.
Before you start
- A Kalliope project configuration in YAML.
- Kalliope runs on Debian-based Linux distributions, including Raspberry Pi; the documentation says a microphone is needed.
Steps
Add a brain entry named
Hello-world.Set its signal order to
say hello.Attach the
sayneuron and set its message toHello world!.
Expected outcome
The configuration describes a vocal order connected to a neuron that says “Hello world!”
Guide limitations
- The example documents the configuration only; it does not specify how to run this configuration or verify speech recognition and output.
- The documented platform scope is Debian-based Linux, including Raspberry Pi.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- kalliope-project/kalliope · Official homepage title · retained in its source language

