# Micro Speech Example This example shows how to run a 20 kB model that can recognize 2 keywords, "yes" and "no", from speech data. The application listens to its surroundings with a microphone and indicates when it has detected a word by displaying data on a screen. ## Deploy to ESP32 The following instructions will help you build and deploy this sample to [ESP32](https://www.espressif.com/en/products/hardware/esp32/overview) devices using the [ESP IDF](https://github.com/espressif/esp-idf). The sample has been tested on ESP-IDF version `release/v4.2` and `release/v4.4` with the following devices: - [ESP32-DevKitC](http://esp-idf.readthedocs.io/en/latest/get-started/get-started-devkitc.html) - [ESP32-S3-DevKitC](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html) - [ESP-EYE](https://github.com/espressif/esp-who/blob/master/docs/en/get-started/ESP-EYE_Getting_Started_Guide.md) ### Install the ESP IDF Follow the instructions of the [ESP-IDF get started guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) to setup the toolchain and the ESP-IDF itself. The next steps assume that the [IDF environment variables are set](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html#step-4-set-up-the-environment-variables) : * The `IDF_PATH` environment variable is set * `idf.py` and Xtensa-esp32 tools (e.g. `xtensa-esp32-elf-gcc`) are in `$PATH` ### Building the example Set the chip target (For esp32s3 target, IDF version `release/v4.4` is needed): ``` idf.py set-target esp32s3 ``` Then build with `idf.py` ``` idf.py build ``` ### Load and run the example To flash (replace `/dev/ttyUSB0` with the device serial port): ``` idf.py --port /dev/ttyUSB0 flash ``` Monitor the serial output: ``` idf.py --port /dev/ttyUSB0 monitor ``` Use `Ctrl+]` to exit. The previous two commands can be combined: ``` idf.py --port /dev/ttyUSB0 flash monitor ``` ### Sample output * When a keyword is detected you will see following output sample output on the log screen: ``` Heard yes (<score>) at <time> ```
To create a project from this example, run:
idf.py create-project-from-example "espressif/esp-tflite-micro^1.3.0:micro_speech"