Windows下小智AI本地环境部署

可以进行聊天、编写程序、播放歌曲等等的小智语音聊天小助手,在Windows环境下修改源代码。本篇文章主要讲解Windows下环境的搭建,WebSocket的修改。注:Python3.12.0、ESP-IDF5.3.2、开发板ESP32S3,环境安装以C盘为例。


1.Git安装

Git
官网下载
安装Windows系统的Git软件。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
接下来都可以选择默认,Next下一步操作。
在这里插入图片描述
在这里插入图片描述
查看git是否安装成功。

查看版本

git -v

帮助命令,查看参数

git --help

在这里插入图片描述
显示以上内容表示安装成功。

2.Python安装

Python环境:
国内高速下载
版本要求Python3.10以上,建议选择Python3.12版本。在这里插入图片描述

3.VSCode安装

VSCode
官网下载
可下载Windows版进行安装。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

3.1 简体中文

中文语言包安装,安装简体中文,然后重启VSCode。

在这里插入图片描述

3.2 ESP-IDF配置

ESP-IDF插件安装
在这里插入图片描述

ESP-IDF下载与配置
在这里插入图片描述
选择ADVENCED,自定义选择安装。
在这里插入图片描述
选择国内高速下载、版本不建议选择5.4.1,可以选择5.3.2。

在这里插入图片描述

受网络的影响,需要先进行下载,下载过程尽量不要中止,下载包含所需要的ESP环境、编译工具等等。

4.环境变量配置

esp-idf本地下载所在位置

注:以安装在C盘为例。
在这里插入图片描述
在这里插入图片描述
编译的工具,默认在根目录
在这里插入图片描述

添加系统环境变量,方便后续命令行操作。

打开“设置”-》“系统信息”-》高级系统设置-》环境变量
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

检查配置

echo %IDF_PATH%                # 输出 ESP-IDF 路径

在这里插入图片描述

xtensa-esp32-elf-gcc -v # 检查编译器是否识别

在这里插入图片描述

python --version              # 确认 Python 3.12.0

进入esp-idf目录,第一次操作,执行安装命令:

start install.bat

然后执行export.bat脚本,显示以下内容表示成功。

start export.bat

在这里插入图片描述

5.参数配置与编译

5.1 源代码下载

打开terminal终端执行git命令:

git clone https://github.com/78/xiaozhi-esp32.git

5.2 VSCode加载项目

打开下载的XIAOZHI-ESP32源代码文件夹,VSCode加载过程中,会提示安装C++扩展选择安装,ESP-IDF加载等,中途不要取消。
在这里插入图片描述

5.3 硬件参数配置

idf.py命令操作,进入esp-idf文件夹,再次执行export.bat脚本。

start export.bat

进入源代码目录下

cd /xxx/xx/xiaozhi-esp32

在这里插入图片描述
项目构建

idf.py build

在这里插入图片描述
芯片类型设置

idf.py set-target esp32s3

在这里插入图片描述
在这里插入图片描述

菜单配置

idf.py menuconfig

上下键控制移动,回车键确认
在这里插入图片描述

连接类型Connection Type选择WebSocket。
在这里插入图片描述
修改websockt地址可以为自己本地的或个人部署的,后面加上/xiaozhi/v1。
在这里插入图片描述
修改为本地的WebSocket,需要自己部署。
在这里插入图片描述
官方默认WebSocket,也可以不修改。
在这里插入图片描述

Board Type可以根据自己的版型选择。
在这里插入图片描述

屏幕分辨率根据自己的OLED尺寸选择。
在这里插入图片描述

按“S”保存配置,然后按ESC回到上一级。

唤醒词的修改。
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

保存后退出。

6.服务端配置

6.1 MiniConda安装

清华源高速下载地址:MiniConda下载
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述添加环境变量
在这里插入图片描述

start activate.bat

在这里插入图片描述

然后执行初始化

conda init --all

在这里插入图片描述

6.2 服务端源代码下载

下载xiaozhi-esp32-server
github访问

创建虚拟环境,如何之前创建过,通过conda命令移除。
conda remove -n xiaozhi-esp32-server --all -y

创建虚拟环境,名称为esp32-server。

conda create -n esp32-server python=3.12 -y

在这里插入图片描述

激活虚拟环境

conda activate esp32-server

退出虚拟环境(非必需)

conda deactivate

6.3 添加清华源通道

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge

安装libopus和ffmpeg

conda install libopus -y
conda install ffmpeg -y

6.3 配置API Key

与Mac下配置config.yaml一致。
在这里插入图片描述
没有data文件夹需要创建并拷贝config.yaml,通过termial终端命令行修改为.config.yaml
在这里插入图片描述
修改配置文件,添加API Key。
model.pt下载可以选择阿里魔塔下载,速度较快。
models文件夹下需要放置model.pt文件。
在这里插入图片描述

7.测试

构建项目

idf.py build

连接硬件esp32s3
烧录

idf.py flash

python app.py启动websocket,不要关闭终端。

python app.py

在这里插入图片描述

8.参考资料

[1]miniconda配置,创建虚拟环境
[2]小智AI聊天机器人百科全书
[3]小智官方文档服务器端配置

9.资源下载

[1]ESP-IDF5.3.2提取码:4TAu
[2]ESP编译工具提取码:4TAu

10.声明

本篇文章在小智官方文档的学习下,Windows系统上配置,将踩过的坑进行总结、经验分享。