# rajkumarpadmanabhan/google-meet-bot architecture

> Architecture diagram of the GitHub repository rajkumarpadmanabhan/google-meet-bot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rajkumarpadmanabhan/google-meet-bot
- Repository: https://github.com/rajkumarpadmanabhan/google-meet-bot

## Overview

AI Google Meet Bot records a meeting while a browser bot joins the call, then transcribes and analyzes the audio into summaries, discussion points, action items, and person-assigned tasks. Users review and edit the saved notes in a dashboard and export them in several formats. The excerpts show Flask routes, bot/recorder startup, persistence, and export handling; the exact stop-to-processing calls are not visible, so those links are marked unverified.

Main entry points: [`app.py`](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/app.py) (Flask API), [`static/js/app.js`](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/static/js/app.js) (Notes Dashboard), [`ai_processor.py`](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/ai_processor.py) (Notes Processor), [`storage.py`](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/storage.py) (Meeting Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_dashboard["Notes Dashboard<br/>[app.js]"]
  node_webapp["Flask API<br/>[app.py]"]
end

subgraph group_meeting["Meeting Capture"]
  node_meetbot["Meet Bot<br/>[bot_engine.py]"]
  node_recorder["Audio Recorder<br/>[audio_recorder.py]"]
  node_wav["WAV Audio"]
end

subgraph group_analysis["Transcript Analysis"]
  node_transcriber["Whisper Transcriber<br/>[transcriber.py]"]
  node_speechtranslation["Transcript Translation<br/>[transcriber.py]"]
  node_noteprocessor["Notes Processor<br/>[ai_processor.py]"]
  node_notetranslation["Notes Translation<br/>[ai_processor.py]"]
end

subgraph group_records["Meeting Records"]
  node_meetingstorage[("Meeting Storage<br/>[storage.py]")]
  node_exports["Report Exports<br/>[storage.py]"]
end

node_user(("Meeting User"))
node_googlemeet["Google Meet"]
node_translator["Google Translator"]
node_summarizer["Local Summarizer"]

node_user -->|"reviews and edits"| node_dashboard
node_dashboard -->|"requests exports"| node_webapp
node_webapp -->|"starts bot"| node_meetbot
node_meetbot -->|"joins meeting"| node_googlemeet
node_webapp -->|"starts recording"| node_recorder
node_recorder -->|"writes audio"| node_wav
node_webapp -.->|"transcribes audio"| node_transcriber
node_transcriber -->|"translates transcript"| node_speechtranslation
node_speechtranslation -->|"uses"| node_translator
node_webapp -.->|"analyzes transcript"| node_noteprocessor
node_noteprocessor -->|"summarizes text"| node_summarizer
node_noteprocessor -->|"translates notes"| node_notetranslation
node_notetranslation -->|"uses"| node_translator
node_webapp -->|"reads and saves"| node_meetingstorage
node_webapp -->|"requests reports"| node_exports
node_exports -->|"reads meeting data"| node_meetingstorage
node_dashboard -.->|"saves edits"| node_meetingstorage

click node_dashboard "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/static/js/app.js"
click node_webapp "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/app.py"
click node_meetbot "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/bot_engine.py"
click node_recorder "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/audio_recorder.py"
click node_transcriber "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/transcriber.py"
click node_speechtranslation "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/transcriber.py"
click node_noteprocessor "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/ai_processor.py"
click node_notetranslation "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/ai_processor.py"
click node_meetingstorage "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/storage.py"
click node_exports "https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/storage.py"

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_dashboard,node_webapp,node_user toneBlue
class node_meetbot,node_recorder,node_wav toneAmber
class node_transcriber,node_speechtranslation,node_noteprocessor,node_notetranslation toneMint
class node_meetingstorage,node_exports toneRose
class node_googlemeet,node_translator,node_summarizer toneIndigo
```

## Components

### User Experience

- [Notes Dashboard](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/static/js/app.js): `static/js/app.js`
- [Flask API](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/app.py): `app.py`

### Meeting Capture

- [Meet Bot](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/bot_engine.py): `bot_engine.py`
- [Audio Recorder](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/audio_recorder.py): `audio_recorder.py`
- **WAV Audio**

### Transcript Analysis

- [Whisper Transcriber](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/transcriber.py): `transcriber.py`
- [Transcript Translation](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/transcriber.py): `transcriber.py`
- [Notes Processor](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/ai_processor.py): `ai_processor.py`
- [Notes Translation](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/ai_processor.py): `ai_processor.py`

### Meeting Records

- [Meeting Storage](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/storage.py): `storage.py`
- [Report Exports](https://github.com/rajkumarpadmanabhan/google-meet-bot/blob/main/storage.py): `storage.py`

### Other components

- **Meeting User**
- **Google Meet**
- **Google Translator**
- **Local Summarizer**

## Connections

- Meeting User → Notes Dashboard: reviews and edits (evidence: `README.md`)
- Notes Dashboard → Flask API: requests exports (evidence: `static/js/app.js`)
- Flask API → Meet Bot: starts bot (evidence: `app.py`)
- Meet Bot → Google Meet: joins meeting (evidence: `bot_engine.py`)
- Flask API → Audio Recorder: starts recording (evidence: `app.py`)
- Audio Recorder → WAV Audio: writes audio (evidence: `audio_recorder.py`)
- Flask API → Whisper Transcriber: transcribes audio (evidence: `app.py`)
- Whisper Transcriber → Transcript Translation: translates transcript (evidence: `transcriber.py`)
- Transcript Translation → Google Translator: uses (evidence: `transcriber.py`)
- Flask API → Notes Processor: analyzes transcript (evidence: `app.py`)
- Notes Processor → Local Summarizer: summarizes text (evidence: `ai_processor.py`)
- Notes Processor → Notes Translation: translates notes (evidence: `ai_processor.py`)
- Notes Translation → Google Translator: uses (evidence: `ai_processor.py`)
- Flask API → Meeting Storage: reads and saves (evidence: `app.py`)
- Flask API → Report Exports: requests reports (evidence: `app.py`)
- Report Exports → Meeting Storage: reads meeting data (evidence: `storage.py`)
- Notes Dashboard → Meeting Storage: saves edits (evidence: `README.md`)
