卡利俄佩

卡利俄佩是一个框架，可以帮助你创建属于自己的个人助理。

其核心理念是通过将一个输入信号（语音指令、定时事件、MQTT消息、GPIO事件等）与一个或多个称为神经元的动作相连接，从而构建你的助理的大脑。

你可以通过简单地选择和组合现有的神经元，无需编写任何代码，就能创建属于自己的卡利俄佩机器人。但如果你需要特定的功能模块，也可以自行开发，并将其添加到你的项目中，同时向社区推荐。

卡利俄佩可以在所有基于Debian的Linux发行版上运行，包括树莓派，并且支持多语言。你唯一需要的设备就是一个麦克风。

卡利俄佩使用起来非常简单，请看这个“Hello World”示例：

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

如果你想了解卡利俄佩能实现哪些功能，可以点击下方的图片：

链接

• 文档
• 卡利俄佩官网
• Android应用
• 聊天室

致谢

卡利俄佩的含义 卡利俄佩源自希腊语，意为“美妙的声音”，由καλλος (kallos)“美丽”和 οψ (ops)“声音”组成。在希腊神话中，她是史诗诗歌与雄辩之神，九位缪斯女神之一。

• kə-LIE-ə-pee （英语）
• Ka-li-o-pé （法语）
• каллиопа （俄语）

许可证

版权所有 © 2018。保留所有权利。

卡利俄佩采用GNU通用公共许可证v3.0。该强 copyleft 许可证要求，在相同许可证下，必须提供许可作品及其修改版本的完整源代码，包括使用许可作品构建的更大规模的作品。同时，必须保留版权声明和许可证信息。贡献者还明确授予专利权。完整的许可证文本请参阅LICENSE.md文件。

Kalliope 快速上手指南

Kalliope 是一个用于构建个人语音助手的框架。它通过将输入信号（如语音指令、定时任务、MQTT 消息等）与执行动作的神经元（Neurons）相连，让你无需编写代码即可通过组合现有模块打造专属机器人。它支持所有基于 Debian 的 Linux 发行版（包括 Raspberry Pi），并支持多语言。

环境准备

在开始之前，请确保你的系统满足以下要求：

• 操作系统：基于 Debian 的 Linux 发行版（如 Ubuntu, Raspbian/Raspberry Pi OS）。
• 硬件设备：必须连接麦克风（用于语音输入），可选配扬声器。
• 前置依赖：
  • Python (支持版本见 PyPI 徽章，通常推荐 Python 3)
  • pip (Python 包管理工具)
  • 音频处理库（如 portaudio19-dev, python3-pyaudio 等，具体视发行版而定）

提示：在安装 Kalliope 前，建议先更新系统软件源并安装基础开发工具：

sudo apt-get update
sudo apt-get install python3-pip portaudio19-dev python3-pyaudio

安装步骤

推荐使用 pip 进行安装。国内用户可指定清华或阿里云镜像源以加速下载。

# 使用国内镜像源安装 Kalliope
pip3 install kalliope -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，你可以初始化一个新的 Kalliope 项目目录（例如命名为 my_assistant）：

kalliope init --name my_assistant
cd my_assistant

基本使用

Kalliope 的核心配置通过 YAML 文件完成。以下是一个最简单的"Hello World"示例，展示如何配置一个语音信号触发回复动作。

1. 打开项目目录下的主配置文件（通常为 brain.yml 或在 brains/ 目录下的具体文件）。
2. 添加以下配置内容：

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

配置说明：

• name: 脑图名称。
• signals: 触发信号。此处 order 表示语音指令，当你对着麦克风说 "say hello" 时触发。
• neurons: 执行动作。此处调用 say 神经元，播放消息 "Hello world!"。

3. 保存文件后，在终端运行以下命令启动助手：

kalliope start

现在，试着对麦克风说 "say hello"，你将听到系统回复 "Hello world!"。

你可以访问 Kalliope 神经元市场 查找更多功能模块（如控制 GPIO、发送通知、查询天气等），只需修改 YAML 配置即可扩展功能，无需编写额外代码。