# prasanna-ks-85/youtube-intelligence-platform architecture

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

- Interactive diagram: https://gitdiagram.com/prasanna-ks-85/youtube-intelligence-platform
- Repository: https://github.com/prasanna-ks-85/youtube-intelligence-platform

## Overview

This is a YouTube video analytics backend: a user submits a video URL, the application invokes an analysis pipeline, and the pipeline returns structured analysis and visualizations. The pipeline’s documented stages cover extraction, preprocessing, classification, summarization, analytics, keyphrases, insights, topics, emotions, explainability, and executive intelligence. Settings, caching, and shared schemas form supporting layers. Some pipeline calls and the application’s interface are not shown in the excerpts; those relationships are marked unverified rather than asserted as observed calls.

Main entry points: [`modules/pipeline.py`](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/pipeline.py) (Pipeline orchestrator), [`modules/extractor.py`](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/extractor.py) (YouTube extraction), [`schemas/pipeline.py`](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/schemas/pipeline.py) (Pipeline result schema), [`app.py`](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/app.py) (Application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Application<br/>[app.py]"]
end

subgraph group_workflow["Analysis workflow"]
  node_pipeline["Pipeline orchestrator<br/>[pipeline.py]"]
  node_extractor["YouTube extraction<br/>[extractor.py]"]
  node_preprocessor["Text preprocessing<br/>[preprocessor.py]"]
  node_keyphrases["Keyphrase extraction"]
  node_classifier["Video classification<br/>[classifier.py]"]
  node_summarizer["Video summarization<br/>[summarizer.py]"]
  node_analytics["Audience analytics<br/>[analytics.py]"]
  node_insights["Executive insights<br/>[insights.py]"]
  node_topics["Topic discovery<br/>[topic_modeler.py]"]
  node_emotions["Emotion analysis"]
  node_explainability["Classification explanation<br/>[explainability.py]"]
  node_executive["Executive intelligence"]
  node_visualizer["Visualizations<br/>[visualizer.py]"]
end

subgraph group_support["Data and support"]
  node_cache[("Analysis cache<br/>[cache.py]")]
  node_settings["Runtime settings<br/>[settings.py]"]
end

subgraph group_contracts["Result contracts"]
  node_models["Core data schemas<br/>[models.py]"]
  node_pipeline_schema["Pipeline result schema<br/>[pipeline.py]"]
  node_domain_schemas["Analysis result schemas"]
end

node_user(("Analyst"))
node_youtube["YouTube services"]

node_user -.->|"submits URL"| node_app
node_app -.->|"invokes analysis"| node_pipeline
node_pipeline -->|"extracts video"| node_extractor
node_extractor -->|"fetches video data"| node_youtube
node_extractor -->|"reads and writes"| node_cache
node_pipeline -.->|"processes text"| node_preprocessor
node_pipeline -.->|"extracts phrases"| node_keyphrases
node_pipeline -->|"classifies video"| node_classifier
node_pipeline -->|"summarizes video"| node_summarizer
node_pipeline -->|"computes analytics"| node_analytics
node_pipeline -.->|"generates insights"| node_insights
node_pipeline -->|"discovers topics"| node_topics
node_pipeline -->|"analyzes emotions"| node_emotions
node_pipeline -.->|"explains classification"| node_explainability
node_pipeline -->|"generates intelligence"| node_executive
node_pipeline -.->|"generates charts"| node_visualizer
node_pipeline -->|"returns result"| node_pipeline_schema
node_pipeline_schema -->|"uses core types"| node_models
node_pipeline_schema -->|"uses analysis types"| node_domain_schemas

click node_app "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/app.py"
click node_pipeline "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/pipeline.py"
click node_extractor "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/extractor.py"
click node_preprocessor "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/preprocessor.py"
click node_keyphrases "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/keyphrase_extractor.py"
click node_classifier "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/classifier.py"
click node_summarizer "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/summarizer.py"
click node_analytics "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/analytics.py"
click node_insights "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/insights.py"
click node_topics "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/topic_modeler.py"
click node_emotions "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/emotion_analyzer.py"
click node_explainability "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/explainability.py"
click node_executive "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/executive_intelligence.py"
click node_visualizer "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/visualizer.py"
click node_cache "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/utils/cache.py"
click node_settings "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/config/settings.py"
click node_models "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/schemas/models.py"
click node_pipeline_schema "https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/schemas/pipeline.py"
click node_domain_schemas "https://github.com/prasanna-ks-85/youtube-intelligence-platform/tree/main/schemas"

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_pipeline,node_extractor,node_preprocessor,node_keyphrases,node_classifier,node_summarizer,node_analytics,node_insights,node_topics,node_emotions,node_explainability,node_executive,node_visualizer toneAmber
class node_cache,node_settings toneMint
class node_models,node_pipeline_schema,node_domain_schemas toneRose
class node_user,node_youtube toneIndigo
```

## Components

### Application entry

- [Application](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/app.py): `app.py`

### Analysis workflow

- [Pipeline orchestrator](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/pipeline.py): `modules/pipeline.py`
- [YouTube extraction](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/extractor.py): `modules/extractor.py`
- [Text preprocessing](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/preprocessor.py): `modules/preprocessor.py`
- [Keyphrase extraction](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/keyphrase_extractor.py): `modules/keyphrase_extractor.py`
- [Video classification](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/classifier.py): `modules/classifier.py`
- [Video summarization](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/summarizer.py): `modules/summarizer.py`
- [Audience analytics](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/analytics.py): `modules/analytics.py`
- [Executive insights](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/insights.py): `modules/insights.py`
- [Topic discovery](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/topic_modeler.py): `modules/topic_modeler.py`
- [Emotion analysis](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/emotion_analyzer.py): `modules/emotion_analyzer.py`
- [Classification explanation](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/explainability.py): `modules/explainability.py`
- [Executive intelligence](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/executive_intelligence.py): `modules/executive_intelligence.py`
- [Visualizations](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/modules/visualizer.py): `modules/visualizer.py`

### Data and support

- [Analysis cache](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/utils/cache.py): `utils/cache.py`
- [Runtime settings](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/config/settings.py): `config/settings.py`

### Result contracts

- [Core data schemas](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/schemas/models.py): `schemas/models.py`
- [Pipeline result schema](https://github.com/prasanna-ks-85/youtube-intelligence-platform/blob/main/schemas/pipeline.py): `schemas/pipeline.py`
- [Analysis result schemas](https://github.com/prasanna-ks-85/youtube-intelligence-platform/tree/main/schemas): `schemas`

### Other components

- **Analyst**
- **YouTube services**

## Connections

- Analyst → Application: submits URL
- Application → Pipeline orchestrator: invokes analysis (evidence: `app.py`)
- Pipeline orchestrator → YouTube extraction: extracts video (evidence: `modules/pipeline.py`)
- YouTube extraction → YouTube services: fetches video data (evidence: `modules/extractor.py`)
- YouTube extraction → Analysis cache: reads and writes (evidence: `modules/extractor.py`)
- Pipeline orchestrator → Text preprocessing: processes text (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Keyphrase extraction: extracts phrases (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Video classification: classifies video (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Video summarization: summarizes video (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Audience analytics: computes analytics (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Executive insights: generates insights (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Topic discovery: discovers topics (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Emotion analysis: analyzes emotions (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Classification explanation: explains classification (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Executive intelligence: generates intelligence (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Visualizations: generates charts (evidence: `modules/pipeline.py`)
- Pipeline orchestrator → Pipeline result schema: returns result (evidence: `modules/pipeline.py`)
- Pipeline result schema → Core data schemas: uses core types (evidence: `schemas/pipeline.py`)
- Pipeline result schema → Analysis result schemas: uses analysis types (evidence: `schemas/pipeline.py`)
