wukong-robot

用 Python 快速打造你的中文智能音箱，还能脑机控制

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署音频音乐 🍴 复刻 1402 🐛 待处理 70 👀 关注 173

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 7131

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

wukong-robot 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类音频音乐

开发团队wzpan

官网地址https://wukong.hahack.com

GitHubhttps://github.com/wzpan/wukong-robot

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,alexa,amazon-echo,anyq,asr,bci,chatgpt,google-home,gpt3,homeassistant,muse,openai,raspeberry-pi,snowboy,speaker,tts,unit

GitHub 星标★ 7131

上线时间2019-01-16 00:00:00

代码更新2024-10-25

仓库体积10.4 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数6

项目介绍

wukong-robot 是一个基于 Python 的中文语音对话机器人/智能音箱开源项目。它解决了从零搭建一个具备语音交互能力的智能音箱的复杂问题，提供了完整的语音唤醒、语音识别、语义理解和语音合成链路。项目核心能力包括：支持多种唤醒词（如“悟空”），可自定义；支持离线或在线语音识别（如讯飞、百度）；内置多轮对话管理，并已集成 ChatGPT 实现更自然的对话；同时支持通过插件机制扩展技能，如控制智能家居、播放音乐、查询天气等。项目还探索了脑机交互，成为首个支持脑机接口的智能音箱，可通过脑电波设备控制。整体设计追求简单、灵活、优雅，适合开发者二次开发和硬件 DIY。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7131

技术标签

ai alexa asr chatgpt gpt3

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 30 分钟部署方式：本地安装 6 步

环境要求

Python 3.7 或更高版本（README 徽章标注 Python>=3.7）
需要获取 wukong-robot 项目源码（GitHub 仓库）
建议准备 tmux 或 supervisor 作为常驻运行环境
需要麦克风等音频输入设备用于语音唤醒与交互

安装与启动步骤

1获取项目代码

从 GitHub 克隆仓库并进入项目目录，后续所有命令都在该目录下执行。
```
git clone https://github.com/wzpan/wukong-robot.git
cd wukong-robot
```
2确认 Python 版本

README 要求 Python 3.7 以上，先确认本机 python3 版本满足要求。
```
python3 --version
```
3按官方教程安装

README 未给出具体依赖安装命令，需按官方安装教程 https://wukong.hahack.com/#/install 完成环境与依赖安装。
4启动程序

在项目目录执行启动脚本。建议在 tmux 或 supervisor 中执行，避免断开终端导致进程退出。
```
python3 wukong.py
```
5生成配置文件

第一次启动时会提示是否到用户目录创建配置文件，输入 y 即可；不建议直接修改 default.yml。
```
y
```
6访问后台管理端

程序运行期间会启动后台管理端，可远程对话、查看修改配置、查看 log。

关键配置

配置项	必填	说明	示例
`$HOME/.wukong/config.yml`	是	用户配置文件，运行时读取；README 建议拷贝一份到这里而不是改 default.yml	`/home/pi/.wukong/config.yml`
`唤醒词`	否	默认唤醒词为 snowboy，可从配置文件自定义	`snowboy`
`后台管理端地址`	否	默认后台管理端访问地址	`http://localhost:5001`
`默认账户名`	否	后台管理端默认用户名，正式使用建议修改	`wukong`
`默认密码`	否	后台管理端默认密码，正式使用建议修改以免泄漏隐私	`wukong@2019`
`厂商 API 应用信息`	是	各语音/语义厂商的 API 建议注册并填自己申请的应用信息，不要用默认配置	`你的讯飞/百度应用 AppID 与 Key`