小智ESP-32后端服务使用教程

小智ESP-32后端服务使用教程

xiaozhi-esp32-server 本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server. 项目地址: https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server

1. 项目介绍

本项目是针对开源智能硬件项目xiaozhi-esp32提供的后端服务。它基于小智通信协议，使用Python语言实现，旨在帮助用户快速搭建ESP32设备控制服务器。项目适用于已经购买并成功对接过ESP32相关硬件的用户，希望独立搭建自己的xiaozhi-esp32后端服务。

2. 项目快速启动

环境准备

• 硬件：一套兼容xiaozhi-esp32的硬件设备。
• 电脑或服务器：建议4核CPU、8G内存的电脑。如果开启ASR也使用API，可运行在2核CPU、2G内存的服务器中。

部署步骤

使用Docker快速部署

1. 拉取Docker镜像

   docker pull xinnan-tech/xiaozhi-esp32-server
   

2. 启动Docker容器

   docker run -d --name xiaozhi-esp32-server -p 8080:8080 xinnan-tech/xiaozhi-esp32-server
   

借助Docker环境运行部署

1. 克隆项目到本地

   git clone https://github.com/xinnan-tech/xiaozhi-esp32-server.git
   

2. 构建Docker镜像

   cd xiaozhi-esp32-server
   docker build -t xiaozhi-esp32-server .
   

3. 启动Docker容器

   docker run -d --name xiaozhi-esp32-server -p 8080:8080 xiaozhi-esp32-server
   

本地源码运行

1. 克隆项目到本地

   git clone https://github.com/xinnan-tech/xiaozhi-esp32-server.git
   

2. 安装依赖

   cd xiaozhi-esp32-server
   pip install -r requirements.txt
   

3. 运行服务

   python app.py
   

3. 应用案例和最佳实践

案例一：使用小智控制家居设备

1. 在配置文件中启用HomeAssistant插件。
2. 配置HomeAssistant的设备、API密钥和基础URL。
3. 使用function_call意图调用HomeAssistant API，实现设备控制。

最佳实践

• 对于响应速度要求较高的场景，推荐使用本地源码运行方式。
• 根据实际需求选择合适的LLM和TTS模块，以优化性能。

4. 典型生态项目

• 小智ESP-32硬件项目：xiaozhi-esp32
• 小智安卓端：xiaozhi-android
• 小智电脑端：xiaozhi-pc

xiaozhi-esp32-server 本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server. 项目地址: https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server