# shouryashinde/quizzer architecture

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

- Interactive diagram: https://gitdiagram.com/shouryashinde/quizzer
- Repository: https://github.com/shouryashinde/quizzer

## Overview

Quizzer turns lecture audio, video, or video URLs into transcripts, AI summaries, and multiple-choice quizzes. Users start at the upload interface; the browser submits media for transcription, then requests generation and views the summary or quiz. Transcription supports AssemblyAI, a YouTube transcript-extraction helper, and a Supadata fallback. The README documents these capabilities; source excerpts show the server routes and processing, but not the EJS templates themselves, so template relationships use documented routing or rendered view names.

Main entry points: [`assemblyServer.js`](https://github.com/shouryashinde/quizzer/blob/main/assemblyServer.js) (Transcription routes), [`summarize.js`](https://github.com/shouryashinde/quizzer/blob/main/summarize.js) (Summary and quiz routes), [`app.js`](https://github.com/shouryashinde/quizzer/blob/main/app.js) (Express app), [`public/js/uploadHandler.js`](https://github.com/shouryashinde/quizzer/blob/main/public/js/uploadHandler.js) (Upload client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Express app<br/>[app.js]"]
  node_upload_view["Upload interface<br/>[upload.ejs]"]
  node_upload_client["Upload client<br/>[uploadHandler.js]"]
  node_transcript_view["Summary view<br/>[transcribe.ejs]"]
  node_quiz_view["Quiz view<br/>[quiz.ejs]"]
end

subgraph group_transcription["Transcription"]
  node_assembly_routes["Transcription routes<br/>[assemblyServer.js]"]
  node_yt_helper["YouTube transcript helper"]
end

subgraph group_learning["Learning generation"]
  node_summarize_routes["Summary and quiz routes<br/>[summarize.js]"]
end

subgraph group_integrations["External services"]
  node_assemblyai{{"AssemblyAI"}}
  node_supadata{{"Supadata"}}
  node_youtube_api{{"YouTube transcript API"}}
  node_nvidia{{"NVIDIA Llama API"}}
end

node_learner(("Learner"))

node_learner -->|"opens"| node_upload_view
node_upload_view -->|"uses"| node_upload_client
node_learner -->|"selects media"| node_upload_client
node_app -->|"mounts routes"| node_assembly_routes
node_app -->|"mounts routes"| node_summarize_routes
node_app -->|"renders"| node_upload_view
node_app -->|"renders"| node_transcript_view
node_app -->|"renders"| node_quiz_view
node_upload_client -->|"posts media"| node_assembly_routes
node_upload_client -->|"uploads media"| node_assemblyai
node_assembly_routes -->|"requests transcription"| node_assemblyai
node_assembly_routes -->|"invokes helper"| node_yt_helper
node_yt_helper -->|"fetches captions"| node_youtube_api
node_assembly_routes -.->|"falls back to"| node_supadata
node_assembly_routes -->|"stores transcript for"| node_summarize_routes
node_summarize_routes -->|"generates learning content"| node_nvidia
node_summarize_routes -->|"renders summary"| node_transcript_view
node_summarize_routes -->|"renders quiz"| node_quiz_view
node_upload_client -->|"requests generation"| node_summarize_routes

click node_app "https://github.com/shouryashinde/quizzer/blob/main/app.js"
click node_upload_view "https://github.com/shouryashinde/quizzer/blob/main/views/upload.ejs"
click node_upload_client "https://github.com/shouryashinde/quizzer/blob/main/public/js/uploadHandler.js"
click node_transcript_view "https://github.com/shouryashinde/quizzer/blob/main/views/transcribe.ejs"
click node_quiz_view "https://github.com/shouryashinde/quizzer/blob/main/views/quiz.ejs"
click node_assembly_routes "https://github.com/shouryashinde/quizzer/blob/main/assemblyServer.js"
click node_yt_helper "https://github.com/shouryashinde/quizzer/blob/main/get_yt_transcript.py"
click node_summarize_routes "https://github.com/shouryashinde/quizzer/blob/main/summarize.js"

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_upload_view,node_upload_client,node_transcript_view,node_quiz_view toneBlue
class node_assembly_routes,node_yt_helper toneAmber
class node_summarize_routes toneMint
class node_assemblyai,node_supadata,node_youtube_api,node_nvidia toneRose
class node_learner toneIndigo
```

## Components

### Web experience

- [Express app](https://github.com/shouryashinde/quizzer/blob/main/app.js): `app.js`
- [Upload interface](https://github.com/shouryashinde/quizzer/blob/main/views/upload.ejs): `views/upload.ejs`
- [Upload client](https://github.com/shouryashinde/quizzer/blob/main/public/js/uploadHandler.js): `public/js/uploadHandler.js`
- [Summary view](https://github.com/shouryashinde/quizzer/blob/main/views/transcribe.ejs): `views/transcribe.ejs`
- [Quiz view](https://github.com/shouryashinde/quizzer/blob/main/views/quiz.ejs): `views/quiz.ejs`

### Transcription

- [Transcription routes](https://github.com/shouryashinde/quizzer/blob/main/assemblyServer.js): `assemblyServer.js`
- [YouTube transcript helper](https://github.com/shouryashinde/quizzer/blob/main/get_yt_transcript.py): `get_yt_transcript.py`

### Learning generation

- [Summary and quiz routes](https://github.com/shouryashinde/quizzer/blob/main/summarize.js): `summarize.js`

### External services

- **AssemblyAI**
- **Supadata**
- **YouTube transcript API**
- **NVIDIA Llama API**

### Other components

- **Learner**

## Connections

- Learner → Upload interface: opens (evidence: `Readme.md`)
- Upload interface → Upload client: uses (evidence: `Readme.md`)
- Learner → Upload client: selects media (evidence: `public/js/uploadHandler.js`)
- Express app → Transcription routes: mounts routes (evidence: `app.js`)
- Express app → Summary and quiz routes: mounts routes (evidence: `app.js`)
- Express app → Upload interface: renders (evidence: `app.js`)
- Express app → Summary view: renders (evidence: `app.js`)
- Express app → Quiz view: renders (evidence: `app.js`)
- Upload client → Transcription routes: posts media (evidence: `public/js/uploadHandler.js`)
- Upload client → AssemblyAI: uploads media (evidence: `public/js/uploadHandler.js`)
- Transcription routes → AssemblyAI: requests transcription (evidence: `assemblyServer.js`)
- Transcription routes → YouTube transcript helper: invokes helper (evidence: `assemblyServer.js`)
- YouTube transcript helper → YouTube transcript API: fetches captions (evidence: `get_yt_transcript.py`)
- Transcription routes → Supadata: falls back to (evidence: `assemblyServer.js`)
- Transcription routes → Summary and quiz routes: stores transcript for (evidence: `assemblyServer.js`)
- Summary and quiz routes → NVIDIA Llama API: generates learning content (evidence: `summarize.js`)
- Summary and quiz routes → Summary view: renders summary (evidence: `summarize.js`)
- Summary and quiz routes → Quiz view: renders quiz (evidence: `summarize.js`)
- Upload client → Summary and quiz routes: requests generation (evidence: `public/js/uploadHandler.js`)
