# divyakurapati375/ai-lecture-notes-generator architecture

> Architecture diagram of the GitHub repository divyakurapati375/ai-lecture-notes-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/divyakurapati375/ai-lecture-notes-generator
- Repository: https://github.com/divyakurapati375/ai-lecture-notes-generator

## Overview

This is a Streamlit AI lecture-notes generator. The user uploads lecture audio/video for preparation and transcription, can extract text from slides with OCR, then generates structured study notes and saves or downloads them as TXT/DOCX. The UI is the workflow orchestrator; audio handling, transcription, OCR, and note generation are distinct backend stages. The README is empty, and transcription/OCR implementations were not sampled, so their internal behavior and some call relationships remain unverified.

Main entry points: [`frontend/app.py`](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/frontend/app.py) (Streamlit app), [`backend/notes.py`](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/notes.py) (Notes generation), [`backend/audio.py`](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/audio.py) (Audio preparation), [`backend/transcription.py`](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/transcription.py) (Transcription)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_app["Streamlit app<br/>[app.py]"]
end

subgraph group_media["Lecture processing"]
  node_audio["Audio preparation<br/>[audio.py]"]
  node_transcription["Transcription<br/>[transcription.py]"]
  node_ocr["Slide OCR<br/>[ocr.py]"]
end

subgraph group_study["Study notes and output"]
  node_notes["Notes generation<br/>[notes.py]"]
  node_exports["TXT/DOCX export<br/>[notes.py]"]
  node_saved["Saved notes"]
end

node_user(("Learner"))
node_gemini{{"Google Gemini"}}

node_user -->|"uses"| node_app
node_app -->|"prepares media"| node_audio
node_app -.->|"requests transcription"| node_transcription
node_app -->|"extracts slide text"| node_ocr
node_app -.->|"requests notes"| node_notes
node_notes -->|"generates content"| node_gemini
node_app -.->|"offers downloads"| node_exports
node_app -->|"writes TXT"| node_saved

click node_app "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/frontend/app.py"
click node_audio "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/audio.py"
click node_transcription "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/transcription.py"
click node_ocr "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/ocr.py"
click node_notes "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/notes.py"
click node_exports "https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/notes.py"
click node_saved "https://github.com/divyakurapati375/ai-lecture-notes-generator/tree/main/frontend/output"

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_app toneBlue
class node_audio,node_transcription,node_ocr toneAmber
class node_notes,node_exports,node_saved toneMint
class node_user,node_gemini toneIndigo
```

## Components

### User interface

- [Streamlit app](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/frontend/app.py): `frontend/app.py`

### Lecture processing

- [Audio preparation](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/audio.py): `backend/audio.py`
- [Transcription](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/transcription.py): `backend/transcription.py`
- [Slide OCR](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/ocr.py): `backend/ocr.py`

### Study notes and output

- [Notes generation](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/notes.py): `backend/notes.py`
- [TXT/DOCX export](https://github.com/divyakurapati375/ai-lecture-notes-generator/blob/main/backend/notes.py): `backend/notes.py`
- [Saved notes](https://github.com/divyakurapati375/ai-lecture-notes-generator/tree/main/frontend/output): `frontend/output`

### Other components

- **Learner**
- **Google Gemini**

## Connections

- Learner → Streamlit app: uses (evidence: `frontend/app.py`)
- Streamlit app → Audio preparation: prepares media (evidence: `frontend/app.py`)
- Streamlit app → Transcription: requests transcription (evidence: `frontend/app.py`)
- Streamlit app → Slide OCR: extracts slide text (evidence: `frontend/app.py`)
- Streamlit app → Notes generation: requests notes (evidence: `frontend/app.py`)
- Notes generation → Google Gemini: generates content (evidence: `backend/notes.py`)
- Streamlit app → TXT/DOCX export: offers downloads (evidence: `frontend/app.py`)
- Streamlit app → Saved notes: writes TXT (evidence: `frontend/app.py`)
