/openai-realtime-embedded-sdk

A SDK to using the Realtime API with Microcontrollers like the ESP32

Primary LanguageC++MIT LicenseMIT

Open RealtimeAPI Embedded SDK

Table of Contents

Platform/Device Support

This SDK has been developed tested on a esp32s3 and linux. You don't need any physical hardware to run this SDK. You can use it from Linux directly.

To use it on hardware purchase either of these microcontrollers. Others may work, but this is what has been developed against.

You can get a ESP32S3 for much less money on eBay/AliExpress.

Installation

protoc must be in your path with protobufc installed.

Call set-target with the platform you are targetting. Today only linux and esp32s3 are supported.

  • idf.py set-target esp32s3

Configure device specific settings. None needed at this time

  • idf.py menuconfig

Set your Wifi SSID + Password as env variables

  • export WIFI_SSID=foo
  • export WIFI_PASSWORD=bar
  • export OPENAI_API_KEY=bing

Build

  • idf.py build

If you built for esp32s3 run the following to flash to the device

  • sudo -E idf.py flash

If you built for linux you can run the binary directly

  • ./build/src.elf

See build.yaml for a Docker command to do this all in one step.

Usage