# pradeep-innovation369/xiazhi-ai-using-esp32 architecture

> Architecture diagram of the GitHub repository pradeep-innovation369/xiazhi-ai-using-esp32, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pradeep-innovation369/xiazhi-ai-using-esp32
- Repository: https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32

## Overview

This repository documents an ESP32-based Xiaozhi voice-assistant build, not its firmware implementation. The documented user workflow is speaking into an I2S microphone, using Wi-Fi for real-time conversations with the Xiaozhi AI platform, and hearing responses through an I2S amplifier and speaker; an OLED displays status. The README also describes flashing firmware with an external tool. No source excerpts are available, so the graph reflects documented hardware capabilities and relationships only.

Main entry points: [`README.md`](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md) (ESP32 controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Assistant device"]
  node_esp32["ESP32 controller<br/>[README.md]"]
  node_wifi["Wi-Fi connection<br/>[README.md]"]
  node_oled["OLED display<br/>[README.md]"]
end

subgraph group_audio["Audio hardware"]
  node_mic["INMP441 microphone<br/>[README.md]"]
  node_amp["MAX98357A amplifier<br/>[README.md]"]
  node_speaker["Speaker<br/>[README.md]"]
end

subgraph group_deployment["Firmware deployment"]
  node_flasher["Firmware flasher"]
end

node_user(("Voice user"))
node_xiaozhi["Xiaozhi AI platform"]

node_user -->|"speaks to"| node_mic
node_mic -->|"voice input"| node_esp32
node_esp32 -->|"connects over"| node_wifi
node_wifi -->|"enables conversations"| node_xiaozhi
node_xiaozhi -->|"returns responses"| node_esp32
node_esp32 -->|"audio output"| node_amp
node_amp -->|"drives"| node_speaker
node_esp32 -->|"shows status"| node_oled
node_flasher -->|"flashes firmware"| node_esp32

click node_esp32 "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"
click node_wifi "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"
click node_oled "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"
click node_mic "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"
click node_amp "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"
click node_speaker "https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_esp32,node_wifi,node_oled,node_user toneBlue
class node_mic,node_amp,node_speaker toneAmber
class node_flasher toneMint
class node_xiaozhi toneIndigo
```

## Components

### Assistant device

- [ESP32 controller](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`
- [Wi-Fi connection](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`
- [OLED display](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`

### Audio hardware

- [INMP441 microphone](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`
- [MAX98357A amplifier](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`
- [Speaker](https://github.com/pradeep-innovation369/xiazhi-ai-using-esp32/blob/main/README.md): `README.md`

### Firmware deployment

- **Firmware flasher**

### Other components

- **Voice user**
- **Xiaozhi AI platform**

## Connections

- Voice user → INMP441 microphone: speaks to (evidence: `README.md`)
- INMP441 microphone → ESP32 controller: voice input (evidence: `README.md`)
- ESP32 controller → Wi-Fi connection: connects over (evidence: `README.md`)
- Wi-Fi connection → Xiaozhi AI platform: enables conversations (evidence: `README.md`)
- Xiaozhi AI platform → ESP32 controller: returns responses (evidence: `README.md`)
- ESP32 controller → MAX98357A amplifier: audio output (evidence: `README.md`)
- MAX98357A amplifier → Speaker: drives (evidence: `README.md`)
- ESP32 controller → OLED display: shows status (evidence: `README.md`)
- Firmware flasher → ESP32 controller: flashes firmware (evidence: `README.md`)
