wukong-robot

wukong-robot 是一个简单、灵活、优雅的中文语音对话机器人/智能音箱项目，目的是让**的 Maker 和 Haker 们也能快速打造个性化的智能音箱。

特性
Demo
环境要求
安装
升级
运行
配置
技能插件
API接口
捐赠
贡献
联系
感谢
FAQ
免责声明

特性

模块化。功能插件、语音识别、语音合成、对话机器人都做到了高度模块化，第三方插件单独维护，方便继承和开发自己的插件。
中文支持。集成百度、科大讯飞、阿里、腾讯等多家中文语音识别和语音合成技术，且可以继续扩展。
对话机器人支持。支持接入图灵机器人、Emotibot 等对话机器人。
全局监听，离线唤醒。支持无接触地离线语音指令唤醒。
灵活可配置。支持定制机器人名字，支持选择语音识别和合成的插件。
智能家居。支持和 mqtt、HomeAssistant 等智能家居协议联动，支持语音控制智能家电。
后台配套支持。提供配套后台，可实现远程操控、修改配置和日志查看等功能。
开放API。可利用后端开放的API，实现更丰富的功能。
安装简单，支持更多平台。相比 dingdang-robot ，舍弃了 PocketSphinx 的离线唤醒方案，安装变得更加简单，代码量更少，更易于维护并且能在 Mac 以及更多 Linux 系统中运行。

wukong-robot 的工作模式：

wukong-robot 被唤醒后，用户的语音指令先经过 ASR 引擎进行 ASR 识别成文本，然后对识别到的文本进行 NLU 解析，再将解析结果进行技能匹配，交给适合处理该指令的技能插件去处理。插件处理完成后，得到的结果再交给 TTS 引擎合成成语音，播放给用户。

虽然一次交互可能包含多次网络请求，不过带来的好处是：每一个环节都可以被修改和定制。

Demo

直接交互的视频 Demo
- coming soon
后台管理端 Demo
- 体验地址：https://bot.hahack.com/ （体验用户名：wukong；体验密码：wukong@2019）
- 备选体验地址：https://bot.sxzz.moe/ （体验用户名：wukong；体验密码：wukong@2019）

环境要求

Python 版本

wukong-robot 只支持 Python 3.x，不支持 Python 2.x 。

设备要求

wukong-robot 支持运行在以下的设备和系统中：

64bit Mac OS X
64bit Ubuntu（12.04 and 14.04）
全系列的树莓派（Raspbian 系统）
Pine 64 with Debian Jessie 8.5（3.10.102）
Intel Edison with Ubilinux （Debian Wheezy 7.8）

安装

见 wukong-robot 安装教程。

升级

python3 wukong.py update

如果提示升级失败，可以尝试在 wukong-robot 的根目录手动执行以下命令，看看问题出在哪。

git pull
pip3 install -r requirements.txt

运行

python3 wukong.py

建议在 tmux 或 supervisor 中执行。

第一次启动时将提示你是否要到用户目录下创建一个配置文件，输入 y 即可。

然后通过唤醒词 “孙悟空” 唤醒 wukong-robot 进行交互（该唤醒词可自定义）。

要让 wukong-robot 暂时屏蔽离线监听，可以使用热词 “悟空别吵”；要让 wukong-robot 恢复离线监听，可以使用热词 “悟空醒醒”。

此外，wukong-robot 默认在运行期间还会启动一个后台管理端，提供了远程对话、查看修改配置、查看 log 等能力。

默认地址：http://localhost:5000
默认账户名：wukong
默认密码：wukong@2019

建议正式使用时修改用户名和密码，以免泄漏隐私。

配置

参考配置文件的注释进行配置即可。注意不建议直接修改 default.yml 里的内容，否则会给后续通过 git pull 更新带来麻烦。你应该拷贝一份放到 $HOME/.wukong/config.yml 中，或者在运行的时候按照提示让 wukong-robot 为你完成这件事。

几个 tips：

建议在运行 wukong-robot 的机器上重新训练一下唤醒词，不同设备录制出来的唤醒词模型使用效果会大打折扣。
不论使用哪个厂商的API，都建议注册并填上自己注册的应用信息，而不要用默认的配置。这是因为这些API都有使用频率和并发数限制，过多人同时使用会影响服务质量。

对于个人用户，可以使用支付宝或者微信进行捐赠，单笔超过 20 元的捐赠者，您的 ID 将可以出现在 wukong-robot 后台管理端的捐赠页面中。

支付宝	微信支付

对于企业用户，建议成为这个项目的 sponsor，您将可以把一个带链接的 logo 放在 wukong-robot 后台管理端的首页、捐赠页面以及 Github 项目首页中。

贡献

喜欢本项目请先打一颗星；
提 bug 请到 issue 页面；
要贡献代码，欢迎 fork 之后再提 pull request；
插件请提交到 wukong-contrib ；

联系

wukong-robot 的主要开发者是潘伟洲。
QQ 群：580447290（人数将满，为控制人数，需付费20元入群，群收入达到一万时将无偿捐赠给壹基金）

感谢

悟空的前身是 dingdang-robot 项目和 jasper-client 项目。感谢 Shubhro Saha, Charles Marsh and Jan Holthuis 在 Jasper 项目上做出的优秀贡献；
感谢三咲智子提供了备选的后台管理端 Demo 体验地址。
感谢 aliciacai 贡献的 wukong-robot 图标。
感谢所有为本项目、 wukong-contrib 项目以及dingdang-robot 项目做出过贡献的人！

FAQ

我能否更换成其他唤醒词，而不是叫“孙悟空”？
- 能。到 snowboy官网训练一个自己的唤醒词，然后将生成的 pmdl 文件放到 ~/.wukong 中，然后修改配置文件中的 hotword 配置即可。

免责声明

wukong-robot 只用作个人学习研究，如因使用 wukong-robot 导致任何损失，本人概不负责。
本开源项目与腾讯叮当助手及优必选悟空项目没有任何关系。

wbj0110 / wukong-robot Goto Github PK

wukong-robot's Introduction

wukong-robot's People

Contributors

Watchers

Recommend Projects

Recommend Topics

Recommend Org