How sanhith30/summarization-platform works
This is an offline-first text, PDF, and YouTube summarization platform. The main workflow runs from the React input UI through the FastAPI routes into input-specific processing and hierarchical summarization, then returns summaries with confidence and explainability data for display. Supporting branches cover streamed text summaries, feedback, health, administration, model inference, caching, and persistence. The map preserves documented capabilities even where implementation excerpts are incomplete; dashed edges mark documented or plausible connections whose callers were not shown.
Main entry points: summarization.py Summarization routes · main.py FastAPI application · router.py API v1 router · HomePage.js Home page
Components 24
User interface
- Home page
frontend/src/pages/HomePage.js - Input controls
frontend/src/components/InputSection.js - Summary state
frontend/src/context/SummarizationContext.js - API client
frontend/src/services/api.js - Summary display
frontend/src/components/SummaryDisplay.js - Settings and history
frontend/src/pages/HomePage.js
API gateway
- FastAPI application
app/main.py - API v1 router
app/api/v1/router.py - Summarization routes
app/api/v1/endpoints/summarization.py - Request and response models
app/api/v1/models.py - Rate limiting
app/core/rate_limiter.py - Feedback routes
app/api/v1/endpoints/feedback.py - Health routes
app/api/v1/endpoints/health.py - Admin routes
app/api/v1/endpoints/admin.py
Summarization pipeline
- PDF extraction
app/services/pdf.py - Video transcripts
app/services/youtube.py - Chunking and map-reduce
app/services/summarization.py - Model ensemble and inference
app/core/models.py
Platform services
- Redis cache
app/core/cache.py - SQL persistence
app/core/database.py - Runtime configuration
app/core/config.py
Other components
- User
- YouTube transcript service
- Local transformer models
Connections 31
- User → Home page: uses
README.md - Home page → Input controls: renders
frontend/src/pages/HomePage.js - Home page → Summary display: renders
frontend/src/pages/HomePage.js - Home page → Settings and history: renders
frontend/src/pages/HomePage.js - Input controls → Summary state: updates
frontend/src/components/InputSection.js - Input controls → API client: submits to
frontend/src/components/InputSection.js - Summary state → Summary display: provides state
- API client → FastAPI application: sends requests
README.md - FastAPI application → API v1 router: mounts
app/main.py - API v1 router → Summarization routes: routes to
app/api/v1/router.py - API v1 router → Feedback routes: routes to
app/api/v1/router.py - API v1 router → Health routes: routes to
app/api/v1/router.py - API v1 router → Admin routes: routes to
app/api/v1/router.py - Summarization routes → Request and response models: validates with
app/api/v1/endpoints/summarization.py - Summarization routes → Rate limiting: checks limits
app/api/v1/endpoints/summarization.py - Summarization routes → Chunking and map-reduce: summarizes text
app/api/v1/endpoints/summarization.py - Summarization routes → PDF extraction: processes PDFs
app/api/v1/endpoints/summarization.py - Summarization routes → Video transcripts: processes videos
app/api/v1/endpoints/summarization.py - Video transcripts → YouTube transcript service: extracts transcripts
- Video transcripts → Chunking and map-reduce: summarizes segments
app/services/youtube.py - Chunking and map-reduce → Model ensemble and inference: runs inference
app/services/summarization.py - Model ensemble and inference → Local transformer models: loads models
README.md - Chunking and map-reduce → Redis cache: caches results
app/services/summarization.py - FastAPI application → SQL persistence: initializes
app/main.py - FastAPI application → Model ensemble and inference: initializes
app/main.py - FastAPI application → Redis cache: initializes
app/main.py - Feedback routes → SQL persistence: stores feedback
app/api/v1/endpoints/feedback.py - Admin routes → Redis cache: manages cache
app/api/v1/endpoints/admin.py - Health routes → Redis cache: checks health
app/api/v1/endpoints/health.py - Summarization routes → SQL persistence: records requests
- FastAPI application → Runtime configuration: reads settings
app/main.py