【亲测免费】 小智ESP32开源项目安装与配置指南

1. 项目基础介绍

小智ESP32是一个开源项目，旨在通过ESP32开发板构建一个AI聊天机器人。该项目以MIT许可证发布，允许用户免费使用并可用于商业用途。项目通过集成多种开源技术，实现了语音识别、语音合成、自然语言处理等功能，用户可以与之进行语音交流。

主要编程语言：C++（76.4%）、C（13.6%）、Python（9.2%）

2. 项目使用的关键技术和框架

• ESP32开发板：作为硬件基础，ESP32提供Wi-Fi和蓝牙功能，适用于物联网项目。
• ESP-SR：基于ESP32的离线语音识别引擎，支持多种语言。
• SenseVoice：声纹识别技术，用于识别用户身份。
• 3D Speaker：大模型TTS（文本到语音）技术，提供高质量的语音输出。
• Qwen, DeepSeek, Doubao：大模型LLM（大型语言模型），用于自然语言处理和生成响应。
• WebSocket/UDP协议：用于流式语音对话的网络协议。
• OLED/LCD显示屏：显示信号强度或对话内容，以及支持多语言显示。

3. 项目安装和配置的准备工作

准备工作

• 硬件：ESP32开发板、OLED/LCD显示屏、麦克风、扬声器等。
• 软件：
  • 安装最新版本的Arduino IDE（用于编程ESP32）。
  • 安装ESP32开发板支持包（通过Arduino IDE的 Boards Manager）。
  • 确保计算机上已安装Git（用于克隆项目代码）。

安装步骤

1. 克隆项目代码：

   打开命令行（终端），执行以下命令克隆项目代码：

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

2. 配置Arduino IDE：

   打开Arduino IDE，选择正确的开发板型号和端口。

3. 安装必要的库：

   在Arduino IDE中，通过“管理库”功能安装以下库：

   • ESP32WiFi
   • ESPAsyncWebServer
   • ArduinoJson
   • PubSubClient
   • Audio

4. 编辑配置文件：

   打开项目文件夹中的CMakeLists.txt文件，根据你的硬件配置编辑相关的设置。

5. 上传代码到ESP32：

   连接ESP32到计算机，选择正确的端口，然后编译并上传代码到ESP32。

   cd xiaozhi-esp32
   arduino --board esp32:esp32:ESP32S3 --port /dev/ttyUSB0 -b -e upload
   

6. 配置Wi-Fi和MQTT：

   在代码中配置Wi-Fi网络的SSID和密码，以及MQTT服务器的地址和端口。

7. 测试：

   重启ESP32，然后通过WebSocket或UDP协议与设备进行对话，测试功能是否正常。

以上步骤为小白级操作，详细配置可能需要根据实际硬件和需求进行调整。如果在安装过程中遇到问题，可以查阅项目文档或在社区中寻求帮助。