# akshayaa-403/wikipedia-summarizer architecture

> Architecture diagram of the GitHub repository akshayaa-403/wikipedia-summarizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akshayaa-403/wikipedia-summarizer
- Repository: https://github.com/akshayaa-403/wikipedia-summarizer

## Overview

##### Project Type and Purpose
- This is a command‐line, open-source Python tool for summarizing Wikipedia articles.
- It’s not a multi‐tier web app or microservice; rather, it’s a single executable script that orchestrates input, data fetching, and three summarization strategies.

##### File Structure
- Top level:
- main.py (the entry point; previously referred to as summarizer.py)
- README.md, LICENSE, .gitignore
- No frontend or database subdirectories—purely a script with external library dependencies.

##### README for Additional Insights
- Three summarization “modules”: LexRank, LSA, BART
- Uses external resources/libraries: Wikipedia API, Sumy, Transformers, NLTK
- Interactive CLI: prompts user for a page name, then prints three summaries.

##### Main Components
a. User Interface (CLI Input/Output)
b. Wikipedia Fetcher Module
c. Summarization Module (with three sub-modules):
- Extractive LexRank (via Sumy)
- Extractive LSA (via Sumy)
- Abstractive BART (via Transformers)
d. External Dependencies/Services:
- Wikipedia API
- Pretrained BART model weights (Hugging Face)
- NLTK resources

##### Relationships and Data Flow
1. User invokes main.py → prompts for article title
2. CLI passes the title to the Wikipedia Fetcher → issues REST call to Wikipedia API
3. Retrieved article text flows into Summarization Module
4. Summarization Module forks into three parallel flows:
– LexRank → Sumy library → summary text
– LSA → Sumy library → summary text
– BART → Transformers library & model weights → summary text
5. All three summaries return to main orchestrator → printed to console

##### Architectural Patterns & Design Principles
- Pipeline pattern: sequential steps with a branching summarization stage
- Separation of concerns: distinct modules for fetching vs. summarizing
- Use of third-party libraries as pluggable components

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User interaction
    User(("User")):::user
    CLI["CLI Interface"]:::internal
    User -->|"invokes main.py"| CLI

    %% Fetching
    Fetcher["Wikipedia Fetcher"]:::internal
    CLI -->|"article title"| Fetcher
    API["Wikipedia API"]:::external
    Fetcher -->|"REST call"| API
    API -->|"article text"| Fetcher

    %% Summarization pipeline
    Summarize["Summarization Module"]:::internal
    Fetcher -->|"raw article text"| Summarize

    subgraph "Summarization Strategies"
        direction TB
        LexRank["LexRank (Sumy)"]:::internal
        LSA["LSA (Sumy)"]:::internal
        BART["BART (Transformers)"]:::internal
    end

    Summarize -->|"text"| LexRank
    Summarize -->|"text"| LSA
    Summarize -->|"text"| BART

    %% External libraries for summarization
    Sumy["Sumy Library"]:::external
    Transformers["Transformers + BART Model"]:::external
    NLTK["NLTK Resources"]:::external

    LexRank -->|"uses Sumy"| Sumy
    LSA -->|"uses Sumy"| Sumy
    BART -->|"uses Transformers & model"| Transformers
    BART -->|"uses NLTK"| NLTK

    %% Output
    Output["Output Printer"]:::internal
    LexRank -->|"summary text"| Output
    LSA -->|"summary text"| Output
    BART -->|"summary text"| Output
    Output -->|"prints summaries"| User

    %% Documentation
    DOC["External Dependencies Docs"]:::doc

    %% Click events
    click CLI "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/main.py"
    click Fetcher "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/main.py"
    click LexRank "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/main.py"
    click LSA "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/main.py"
    click BART "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/main.py"
    click DOC "https://github.com/akshayaa-403/wikipedia-summarizer/blob/main/README.md"

    %% Styles
    classDef internal fill:#e0f7e9,stroke:#2d7a46,stroke-width:1px
    classDef external fill:#e1f0ff,stroke:#186faf,stroke-width:1px
    classDef user fill:#f0f0f0,stroke:#888,stroke-width:1px
    classDef doc fill:#f9f4dc,stroke:#b58900,stroke-width:1px
```
