# 033-archita/lectureai architecture

> Architecture diagram of the GitHub repository 033-archita/lectureai, 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/033-archita/lectureai
- Repository: https://github.com/033-archita/lectureai

## Overview

LectureAI turns uploaded recordings or YouTube videos into transcripts and structured study notes, then displays and exports the results. The evidenced workflow runs through the Streamlit app, which invokes transcription, note generation, keyword extraction, and note formatting. The README documents YouTube input and exports; source excerpts show the downloader and recording utility, but not their wiring into the app, so those links are omitted or marked unverified. The app excerpt is partial, so some UI and feature relationships remain uncertain.

Main entry points: [`app.py`](https://github.com/033-archita/lectureai/blob/main/app.py) (Streamlit app), [`api_models.py`](https://github.com/033-archita/lectureai/blob/main/api_models.py) (Transcription), [`youtube_utils.py`](https://github.com/033-archita/lectureai/blob/main/youtube_utils.py) (YouTube downloader), [`audio_recorder.py`](https://github.com/033-archita/lectureai/blob/main/audio_recorder.py) (Browser recorder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Audio inputs"]
  node_app["Streamlit app<br/>[app.py]"]
  node_youtube["YouTube downloader<br/>[youtube_utils.py]"]
  node_recorder["Browser recorder<br/>[audio_recorder.py]"]
end

subgraph group_ai["AI processing"]
  node_transcription["Transcription<br/>[api_models.py]"]
  node_assembly{{"AssemblyAI"}}
  node_note_generation["Note generation<br/>[api_models.py]"]
  node_groq{{"Groq LLM"}}
  node_keyword_extraction["Keyword extraction<br/>[api_models.py]"]
  node_keyword_analysis["Keyword utilities<br/>[keyword_utils.py]"]
end

subgraph group_results["Study materials"]
  node_section_display["Notes display<br/>[app.py]"]
  node_note_formatting["Note formatting<br/>[formatter.py]"]
  node_transcript_view["Transcript view<br/>[app.py]"]
  node_downloads["Downloads<br/>[app.py]"]
  node_flashcards["Flashcard export<br/>[formatter.py]"]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"transcribes via"| node_transcription
node_app -->|"generates notes"| node_note_generation
node_app -->|"extracts keywords"| node_keyword_extraction
node_app -->|"formats notes"| node_note_formatting
node_transcription -->|"transcribes with"| node_assembly
node_note_generation -->|"generates with"| node_groq
node_keyword_extraction -->|"extracts with"| node_groq
node_app -->|"renders"| node_section_display
node_app -->|"renders"| node_transcript_view
node_app -->|"offers"| node_downloads
node_app -.->|"may use"| node_youtube
node_app -.->|"may embed"| node_recorder

click node_app "https://github.com/033-archita/lectureai/blob/main/app.py"
click node_youtube "https://github.com/033-archita/lectureai/blob/main/youtube_utils.py"
click node_recorder "https://github.com/033-archita/lectureai/blob/main/audio_recorder.py"
click node_transcription "https://github.com/033-archita/lectureai/blob/main/api_models.py"
click node_note_generation "https://github.com/033-archita/lectureai/blob/main/api_models.py"
click node_keyword_extraction "https://github.com/033-archita/lectureai/blob/main/api_models.py"
click node_keyword_analysis "https://github.com/033-archita/lectureai/blob/main/keyword_utils.py"
click node_section_display "https://github.com/033-archita/lectureai/blob/main/app.py"
click node_note_formatting "https://github.com/033-archita/lectureai/blob/main/formatter.py"
click node_transcript_view "https://github.com/033-archita/lectureai/blob/main/app.py"
click node_downloads "https://github.com/033-archita/lectureai/blob/main/app.py"
click node_flashcards "https://github.com/033-archita/lectureai/blob/main/formatter.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_app,node_youtube,node_recorder toneBlue
class node_transcription,node_assembly,node_note_generation,node_groq,node_keyword_extraction,node_keyword_analysis toneAmber
class node_section_display,node_note_formatting,node_transcript_view,node_downloads,node_flashcards toneMint
class node_student toneIndigo
```

## Components

### Audio inputs

- [Streamlit app](https://github.com/033-archita/lectureai/blob/main/app.py): `app.py`
- [YouTube downloader](https://github.com/033-archita/lectureai/blob/main/youtube_utils.py): `youtube_utils.py`
- [Browser recorder](https://github.com/033-archita/lectureai/blob/main/audio_recorder.py): `audio_recorder.py`

### AI processing

- [Transcription](https://github.com/033-archita/lectureai/blob/main/api_models.py): `api_models.py`
- **AssemblyAI**
- [Note generation](https://github.com/033-archita/lectureai/blob/main/api_models.py): `api_models.py`
- **Groq LLM**
- [Keyword extraction](https://github.com/033-archita/lectureai/blob/main/api_models.py): `api_models.py`
- [Keyword utilities](https://github.com/033-archita/lectureai/blob/main/keyword_utils.py): `keyword_utils.py`

### Study materials

- [Notes display](https://github.com/033-archita/lectureai/blob/main/app.py): `app.py`
- [Note formatting](https://github.com/033-archita/lectureai/blob/main/formatter.py): `formatter.py`
- [Transcript view](https://github.com/033-archita/lectureai/blob/main/app.py): `app.py`
- [Downloads](https://github.com/033-archita/lectureai/blob/main/app.py): `app.py`
- [Flashcard export](https://github.com/033-archita/lectureai/blob/main/formatter.py): `formatter.py`

### Other components

- **Student**

## Connections

- Student → Streamlit app: uses (evidence: `README.md`)
- Streamlit app → Transcription: transcribes via (evidence: `app.py`)
- Streamlit app → Note generation: generates notes (evidence: `app.py`)
- Streamlit app → Keyword extraction: extracts keywords (evidence: `app.py`)
- Streamlit app → Note formatting: formats notes (evidence: `app.py`)
- Transcription → AssemblyAI: transcribes with (evidence: `api_models.py`)
- Note generation → Groq LLM: generates with (evidence: `api_models.py`)
- Keyword extraction → Groq LLM: extracts with (evidence: `api_models.py`)
- Streamlit app → Notes display: renders (evidence: `app.py`)
- Streamlit app → Transcript view: renders (evidence: `app.py`)
- Streamlit app → Downloads: offers (evidence: `app.py`)
- Streamlit app → YouTube downloader: may use
- Streamlit app → Browser recorder: may embed
