• 中文版本
• Promotional Video

Important Note:

Upon receiving the ESP32-S3-BOX and ESP32-S3-BOX-Lite, we advise updating the built-in factory firmware to ensure you have the latest bug fixes. In the master branch, we will gradually offer limited support for these two development boards. For further information, kindly refer to the examples readme.

The ESP-BOX is an advanced AIoT, Edge AI, and IIoT applications development platform released by Espressif Systems. The ESP32-S3-BOX, ESP32-S3-BOX-Lite, and ESP32-S3-BOX-3 are a series of development boards designed for this platform, they are built on Espressif’s powerful ESP32-S3 Wi-Fi + Bluetooth 5 (LE) SoC and feature compact and beautiful enclosures. Leveraging the multi-functional accessories and reliable examples from the repo’s, these development boards cater to both prototyping new projects and building complex IoT systems, providing a perfect balance of form and function.

ESP-BOX provides a platform for developing applications in various domains, including Offline Voice Assistants, Online AI Chatbots (developed using OpenAI and other large language model platforms), Matter Device/Controller, Robot Controller, USB Device/Host, Wireless Sensor Application and a wide range of Human Machine Interaction (HMI) applications. Experience the possibilities—add one to your toolkit and explore the limitless potential!

Product Name	Product Figure	Marketing Status
ESP32-S3-BOX		End of Life User Guide
ESP32-S3-BOX-Lite		Active User Guide
ESP32-S3-BOX-3 (beta)		Active User Guide

• An out-of-the-box entry-level edge AI + HMI application development board.
• FreeRTOS-based four-in-one voice interaction panel: offline voice recognition, network communication, screen display, peripheral control.
• Supports far-field voice interaction with 2 mics.
• Offline voice wake-up and commands recognition with high wake-up rate.
• Allows continuous recognition, wake-up interrupt, and over 200 customizable command words.
• Flexible and versatile home automation solutions: Matter, Home Assistant, ESP-RainMaker
• Visual drag-and-drop GUI development: LVGL SquareLine Studio, Embedded Wizard, etc.
• Rich development framework: ESP-IDF, Arduino, PlatformIO, Circuit Python, and more.

• Schematic and PCB Source File
• Shell 3D Print Source File
• Built-in Firmware Source Code
• Other Examples

Based on Apache 2.0 open source license, you can modify, develop, or distribute the contents freely.

• It is recommended to start by reading the product Hardware Overview.
• Next you can explore the Getting Started.
• For exploring interesting sensor demos, please refer to Sensor Applications.
• For experiencing voice assistant, please refer to the Voice Assistance Control.
• For experiencing a more humanized interactive experience, please refer to the Continuous Speech Recognition.
• For defining the speech commands by mobile APP, please refer to the ESP BOX APP User Guide.
• For switching the voice model language, please refer to Switch Voice Model Language.
• For product exploded-view and disassembly tutorial, please refer to Disassembly Tutorial.
• For more details of hardware information, please refer to the Hardware Overview.
• For latest version firmware, please refer to the Firmware Update.

ESP-BOX integrates components commonly used in AIoT development that you can leverage to build your own applications.

• Step 1. ESP-IDF (Espressif IoT Development Framework) is required to build the application. If this is your first time using the ESP-IDF, please refer to ESP-IDF development guide to understand the open-source drivers and components provided by Espressif.
• Step 2. Next, setting up development environment. Please refer to ESP-IDF (release/v5.1) Installation Step by Step.
• Step 3. Run command git clone --recursive https://github.com/espressif/esp-box.git to download the code of this project and then switch the ESP-IDF version to specified version;
• Step 4. Take a small step, you can build and flash a simple example.
• Step 5. Moving further, please read ESP-BOX technical architecture to understand the technical details.
• Step 6. Going deeper, please read ESP Speech Recognition Application Guide, ESP RainMaker Programming Guide, LVGL GUI Quick overview.
• Step 7. For extended function, please read Pmod™ compatible headers and ESP-IDF API reference, to develop drivers for more extended devices.

The ESP BOX APP is built based on the commercial mobile APP architecture, Nova Home, which provides fancy UI and better user experience but has limited openness. To gain access to it, customers are required to contact us commercially via email at [email protected]. For developer, we offer ESP RainMaker solution, which includes publicly available development document and API guide. Below is the pathway to access them:

• ESP RainMaker Get Started
• ESP RainMaker Programming Guide
• RainMaker App APIs Definitions

• If you have any technical issues, please submit issue tickets at GitHub Issues or forum esp32.com for help.
• If you are interested in ESP-BOX project, welcome to the ESP-BOX forum to share with us your ideas.

We welcome any open-source software or hardware contribution. If you have any examples you want to share with us, please click the Contributions Guide and commit to the Pull Requests to contribute your code.