readme update

This commit is contained in:
akdeb 2025-06-12 17:24:15 +01:00
parent 47647d8d7e
commit b0abf42c99
3 changed files with 28 additions and 26 deletions

View file

@ -15,7 +15,7 @@ Realtime AI Speech powered by **OpenAI Realtime API** and **Gemini Live API**, E
</div>
## ⚡️ Features SOTA Realtime AI Speech Models on an ESP32
## ⚡️ With SOTA Realtime AI Speech Models on an ESP32
<div align="center" class="flex flex-row gap-4">
@ -26,7 +26,7 @@ Realtime AI Speech powered by **OpenAI Realtime API** and **Gemini Live API**, E
</div>
## 📽️ Demo Video
## 📽️ Demo Video [(✨ Gemini demo)](https://youtu.be/_zUBue3pfVI)
<div align="center">
<a href="https://www.youtube.com/watch?v=o1eIAwVll5I" target="_blank">
@ -40,6 +40,9 @@ Realtime AI Speech powered by **OpenAI Realtime API** and **Gemini Live API**, E
</div>
Video links: [OpenAI Demo](https://youtu.be/o1eIAwVll5I) | [Gemini Demo](https://youtu.be/_zUBue3pfVI)
## 👷‍♀️ DIY Hardware Design
<img src="assets/pcb-design.png" alt="Hardware Setup" width="100%">
@ -94,8 +97,6 @@ npm run dev
4. **Choose edge server option**
<img src="assets/devices.png" alt="Elato Mode" width="100%">
- **ELATO MODE:** Got your own ESP32 DIY hardware device? We offer a fully hosted edge server for you to use! Register your device on the [settings page](https://www.elatoai.com/home/settings/device) and it will automatically connect to our edge server. Check out our [Pricing page](https://www.elatoai.com/#pricing) for more details.
- **DEV MODE:** Alternatively, you can run your own edge server locally by following the instructions below and in the [Deno server README](server-deno/README.md).
@ -134,21 +135,7 @@ Build and upload the firmware to your ESP32 device. The ESP32 should open an `EL
Once your Wifi credentials are configured, turn the device off and on again and it should connect to your Wifi and your server. Now you can talk to your AI Character!
## 🤖🤖🤖 Getting Started with multiple devices
1. Register your device by adding your ESP32 Device's MAC Address and a unique user code to the `devices` table in Supabase.
> **Pro Tip:** To find your ESP32-S3 Device's MAC Address, build and upload `test/print_mac_address_test.cpp` using PlatformIO and view the serial monitor.
2. Register your user account to this device by adding your unique user code to the [Settings page](http://localhost:3000/home/settings) in the NextJS Frontend. This links your device to your account.
3. Set DEV_MODE to `False` in your `frontend-nextjs/.env.local` env variable.
> **Pro Tip:** If you're testing locally, you can keep enabled the `DEV_MODE` macro in the `Config.h` file of your firmware and the Deno server env variable to use your local IP addresses for testing.
4. Now you can register multiple devices to your account by repeating the process above.
## [🤖🤖🤖 Getting Started with multiple devices](./docs/MultipleDevices.md)
## Project Architecture
@ -159,7 +146,7 @@ ElatoAI consists of three main components:
3. **ESP32 IoT Client** (`PlatformIO/Arduino`) - to receive the websocket connections from the Edge Server Functions and send audio to the OpenAI and Gemini API via the Deno edge server.
## 🌟 Features
## 🌟 Full list of features
1. **Realtime Speech-to-Speech**: Instant speech conversion powered by OpenAI's Realtime API and Gemini's Live API.
2. **Create Custom AI Agents**: Create custom agents with different personalities and voices.
@ -198,7 +185,7 @@ ElatoAI consists of three main components:
## 📈 Core Use Cases
We have a [Usecases.md](Usecases.md) file that outlines the core use cases for the [Elato AI device](https://www.elatoai.com/products) or any other custom conversational AI device.
We have a [Usecases.md](./docs/Usecases.md) file that outlines the core use cases for the [Elato AI device](https://www.elatoai.com/products) or any other custom conversational AI device.
## High-Level Flowchart

15
docs/MultipleDevices.md Normal file
View file

@ -0,0 +1,15 @@
## 🤖🤖🤖 Getting Started with multiple devices
1. Register your device by adding your ESP32 Device's MAC Address and a unique user code to the `devices` table in Supabase.
> **Pro Tip:** To find your ESP32-S3 Device's MAC Address, build and upload `test/print_mac_address_test.cpp` using PlatformIO and view the serial monitor.
2. Register your user account to this device by adding your unique user code to the [Settings page](http://localhost:3000/home/settings) in the NextJS Frontend. This links your device to your account.
3. Set DEV_MODE to `False` in your `frontend-nextjs/.env.local` env variable.
> **Pro Tip:** If you're testing locally, you can keep enabled the `DEV_MODE` macro in the `Config.h` file of your firmware and the Deno server env variable to use your local IP addresses for testing.
4. Now you can register multiple devices to your account by repeating the process above.

View file

@ -1,10 +1,10 @@
# [WIP] Here are some use cases for the Elato AI device
<img src="./assets/usecases.png" alt="Build Custom AI Toys" width="40%">
<img src="./../assets/usecases.png" alt="Build Custom AI Toys" width="40%">
*Cute AI plush toys for kids, elderly, and more!*
## Healthcare & Companionship:
## Healthcare ideas:
1. **Kid-friendly hospital buddies**: Plush toys that help kids feel less scared during hospital stays with stories and games when they need them most.
@ -16,7 +16,7 @@
5. **Meditation guides**: Calming voices that walk you through relaxation exercises whenever you need a mental break.
## Learning & Play:
## Learning & play:
1. **Language conversation partners**: Practice your Spanish, French or any language with a patient friend who never gets tired of helping you get better.
@ -26,7 +26,7 @@
4. **Social skills practice**: A safe space for kids to practice conversations, especially helpful for children on the autism spectrum.
## Helpful Assistants:
## Helpful assistants:
1. **Simple communication hubs**: Easy voice tools for people who struggle with technology to call family with simple commands.
@ -34,7 +34,7 @@
3. **Custom helpers**: Voice systems designed specifically for people with mobility challenges.
## Creative Applications:
## Creative applications:
1. **Interactive exhibits**: Imagine talking to Einstein at a science museum or a dinosaur at a natural history exhibit.