52

GitHub - wzpan/wukong-robot: ? wukong-robot 是一个简单、灵活、优雅的中文语音对话...

 6 years ago
source link: https://github.com/wzpan/wukong-robot
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

README.md

wukong-robot

wukong-robot

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

wukong-project 捐赠 Python3 docker-pulls QQ群

68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77756b6f6e672d726f626f742f73706f6e736f72732e7376673f6176617461724865696768743d3336

Table of Contents

特性

wukong-robot

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

wukong-robot 的工作模式：

wukong-robot 的工作模式

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

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

Demo

  • 直接交互的视频 Demo
    • coming soon
  • 后台管理端 Demo

环境要求

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 等能力。

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

配置

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

几个 tips：

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

技能插件

API 接口

wukong-robot 的后台接口是开放 Web API 的，可以使用 Restful 方式调用，见 后台API。

捐赠

您的捐赠将鼓励我继续完善 wukong-robot。

  • 对于个人用户，可以使用支付宝或者微信进行捐赠，单笔超过 20 元的捐赠者，您的 ID 将可以出现在 wukong-robot 后台管理端的捐赠页面中。
支付宝 微信支付 687474703a2f2f68616861636b2e636f6d2f696d616765732f6d6973632f616c697061792e706e67 687474703a2f2f68616861636b2e636f6d2f696d616765732f6d6973632f7765636861747061792e6a706567
  • 对于企业用户，建议成为这个项目的 sponsor，您将可以把一个带链接的 logo 放在 wukong-robot 后台管理端的首页、捐赠页面以及 Github 项目首页中。

68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77756b6f6e672d726f626f742f73706f6e736f72732e7376673f77696474683d383930

贡献

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

联系

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

感谢

FAQ

  • 我能否更换成其他唤醒词，而不是叫“孙悟空”？

    • 能。到 snowboy官网 训练一个自己的唤醒词，然后将生成的 pmdl 文件放到 ~/.wukong 中，然后修改配置文件中的 hotword 配置即可。

免责声明

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

report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK