# bishwaghimire/ai-learning-roadmaps architecture

> Architecture diagram of the GitHub repository bishwaghimire/ai-learning-roadmaps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bishwaghimire/ai-learning-roadmaps
- Repository: https://github.com/bishwaghimire/ai-learning-roadmaps

## Overview

1. **Repository type and purpose**
   - This is not an application codebase; it is a **curated knowledge hub** for AI/ML/DL learning.
   - The architecture is centered on **content organization**, not runtime services or build pipelines.

2. **Primary entry point**
   - `README.md` is the main navigation surface and effectively the “homepage.”
   - It explains who the repo is for, how to use it, and the recommended learning sequence.

3. **Core content subsystem: roadmap layer**
   - The `roadmaps/` directory is the main structural backbone.
   - Each markdown file is a standalone learning path for a domain:
     - foundations: AI, Data Science, ML, Deep Learning
     - specializations: CV, NLP, LLM, GenAI, RAG
     - engineering/research tracks: MLOps, Research Scientist, AI Safety/Alignment
   - These roadmaps are the main dependency graph for the repo: users typically move from broad foundations to specializations.

4. **Reference library subsystem: books and PDFs**
   - The `resources/` directory holds offline learning materials grouped by subject:
     - `foundations/`
     - `Data-Science/`
     - `ML/`
     - `DL/`
     - `AI/`
   - This is a curated document store, mainly PDFs, intended to support the roadmap items with deeper reading.

5. **Presentation and branding assets**
   - `assets/ai-image.png` is the only visible media asset in the tree.
   - It serves documentation/branding purposes inside the README, not product functionality.

6. **Supplementary documentation and governance**
   - `CONTRIBUTING.md` defines the collaboration boundary for new content and curation rules.
   - `LICENSE` sets the repository’s redistribution terms.
   - `Packages.md` provides environment/tooling guidance for learners and acts as a setup reference.

7. **External knowledge and service boundaries**
   - The repo heavily depends on **external links** for videos, courses, communities, papers, and cloud/platform docs.
   - These include YouTube, MIT OCW, Coursera, arXiv, Hugging Face, OpenAI/Google/DeepMind blogs, and community platforms like Reddit, Discord, Telegram, and Stack Overflow.
   - Architecture-wise, the repo is a **curated index** that routes users to external learning systems rather than hosting them.

8. **How information flows through the repo**
   - A learner starts in `README.md`.
   - From there, they choose a roadmap in `roadmaps/`.
   - Each roadmap points to relevant concepts and often to resources in `resources/` or external references.
   - The flow is essentially: **overview → structured path → deep reference material → external practice/learning sources**.

9. **Content layering**
   - The repo separates content into distinct levels:
     - orientation and sequencing in `README.md`
     - detailed progression in `roadmaps/`
     - long-form source material in `resources/`
     - environment/tooling guidance in `Packages.md`
   - This layered structure is important for diagramming because it shows a clear top-down learning funnel.

10. **Domain boundaries**
   - The repository spans multiple AI subdomains but keeps them logically isolated.
   - For example, ML/DL foundations are separated from RAG, LLMs, MLOps, and AI safety, while still linked through the roadmap hierarchy.
   - This prevents the repo from becoming a flat list of links and gives it a modular architecture.

11. **Technology relevance**
   - The repo is documentation-first, but the tooling it references shapes the ecosystem:
     - Python, Jupyter/Colab for learning
     - PyTorch, TensorFlow, JAX for modeling
     - Hugging Face, LangChain, LlamaIndex, vector DBs, MLflow/W&B/DVC for modern AI workflows
   - These are not implemented in the repo, but they define the expected downstream stack for learners.

12. **What is intentionally absent**
   - There is no code execution layer, no CI/CD, no backend, no database, and no packaged app.
   - So the architecture diagram should emphasize **curation and navigation**, not runtime components.

13. **Best diagram framing**
   - Model the repo as a **content platform** with three main zones:
     - navigation/index (`README.md`)
     - structured learning paths (`roadmaps/`)
     - offline reference materials (`resources/`)
   - Add external services as outbound dependencies, since much of the educational value comes from links out to third-party content.

Main entry points: [`roadmaps`](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/roadmaps) (Roadmaps), [`resources`](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources) (Resource library), [`README.md`](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/README.md) (README), [`roadmaps/ml-roadmap.md`](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ml-roadmap.md) (Foundations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation"]
  node_readme["README<br/>entrypoint<br/>[README.md]"]
  node_contributing["Contributing<br/>governance<br/>[CONTRIBUTING.md]"]
  node_packages["Packages<br/>setup guide<br/>[Packages.md]"]
  node_license["License<br/>legal"]
  node_brand["Brand asset<br/>media"]
end

subgraph group_roadmaps["Roadmaps"]
  node_roadmap_overview{{"Roadmaps<br/>learning paths"}}
  node_foundations["Foundations<br/>roadmap<br/>[ml-roadmap.md]"]
  node_ai["AI<br/>roadmap<br/>[ai-roadmap.md]"]
  node_data_science["Data Science<br/>roadmap"]
  node_ml["ML<br/>roadmap<br/>[ml-roadmap.md]"]
  node_dl["Deep Learning<br/>roadmap"]
  node_specializations{{"Specializations<br/>roadmap cluster"}}
  node_cv["Computer Vision<br/>roadmap"]
  node_nlp["NLP<br/>roadmap<br/>[nlp-roadmap.md]"]
  node_llm["LLM<br/>roadmap<br/>[llm-roadmap.md]"]
  node_genai["GenAI<br/>roadmap"]
  node_rag["RAG<br/>roadmap<br/>[rag-roadmap.md]"]
  node_ops_research{{"Ops & Research<br/>roadmap cluster"}}
  node_mlops["MLOps<br/>roadmap"]
  node_research["Research Scientist<br/>roadmap"]
  node_safety["AI Safety<br/>roadmap"]
end

subgraph group_resources["Resources"]
  node_resource_library[("Resource library<br/>document store")]
  node_foundations_books["Foundations books<br/>resource set"]
  node_ds_books["Data Science books<br/>resource set"]
  node_ml_books["ML books<br/>resource set"]
  node_dl_books["DL books<br/>resource set"]
  node_ai_books["AI books<br/>resource set"]
end

subgraph group_external["External sources"]
  node_external_links(("External links<br/>outbound index"))
  node_courses(("Courses<br/>external source"))
  node_papers(("Papers<br/>external source"))
  node_platforms(("Platforms<br/>external source"))
  node_communities(("Communities<br/>external source"))
end

node_readme -->|"starts here"| node_roadmap_overview
node_readme -->|"references"| node_resource_library
node_readme -->|"setup"| node_packages
node_readme -->|"rules"| node_contributing
node_readme -.->|"outbound"| node_external_links
node_roadmap_overview -->|"baseline"| node_foundations
node_roadmap_overview -->|"domain"| node_ai
node_roadmap_overview -->|"domain"| node_data_science
node_roadmap_overview -->|"domain"| node_ml
node_roadmap_overview -->|"domain"| node_dl
node_roadmap_overview -->|"branches"| node_specializations
node_specializations -->|"track"| node_cv
node_specializations -->|"track"| node_nlp
node_specializations -->|"track"| node_llm
node_specializations -->|"track"| node_genai
node_specializations -->|"track"| node_rag
node_roadmap_overview -->|"advanced paths"| node_ops_research
node_ops_research -->|"track"| node_mlops
node_ops_research -->|"track"| node_research
node_ops_research -->|"track"| node_safety
node_foundations -->|"supported by"| node_foundations_books
node_data_science -->|"supported by"| node_ds_books
node_ml -->|"supported by"| node_ml_books
node_dl -->|"supported by"| node_dl_books
node_ai -->|"supported by"| node_ai_books
node_resource_library -->|"contains"| node_foundations_books
node_resource_library -->|"contains"| node_ds_books
node_resource_library -->|"contains"| node_ml_books
node_resource_library -->|"contains"| node_dl_books
node_resource_library -->|"contains"| node_ai_books
node_external_links -->|"includes"| node_courses
node_external_links -->|"includes"| node_papers
node_external_links -->|"includes"| node_platforms
node_external_links -->|"includes"| node_communities

click node_readme "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/README.md"
click node_contributing "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/CONTRIBUTING.md"
click node_packages "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/Packages.md"
click node_license "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/LICENSE"
click node_roadmap_overview "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/roadmaps"
click node_foundations "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ml-roadmap.md"
click node_ai "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ai-roadmap.md"
click node_data_science "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/data-science-roadmap.md"
click node_ml "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ml-roadmap.md"
click node_dl "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/deep-learning-roadmap.md"
click node_cv "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/computer-vision-roadmap.md"
click node_nlp "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/nlp-roadmap.md"
click node_llm "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/llm-roadmap.md"
click node_genai "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/generative-ai-roadmap.md"
click node_rag "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/rag-roadmap.md"
click node_mlops "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/mlops-production-ai-roadmap.md"
click node_research "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/research-scientist-roadmap.md"
click node_safety "https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ai-safety-alignment-roadmap.md"
click node_resource_library "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources"
click node_foundations_books "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/foundations"
click node_ds_books "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/Data-Science"
click node_ml_books "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/ML"
click node_dl_books "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/DL"
click node_ai_books "https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/AI"

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_readme,node_contributing,node_packages,node_license,node_brand toneBlue
class node_roadmap_overview,node_foundations,node_ai,node_data_science,node_ml,node_dl,node_specializations,node_cv,node_nlp,node_llm,node_genai,node_rag,node_ops_research,node_mlops,node_research,node_safety toneAmber
class node_resource_library,node_foundations_books,node_ds_books,node_ml_books,node_dl_books,node_ai_books toneMint
class node_external_links,node_courses,node_papers,node_platforms,node_communities toneRose
```

## Components

### Navigation

Top-level orientation, usage, and governance for the knowledge hub.

- [README](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/README.md): entrypoint · Main homepage and navigation surface for learners. · `README.md`
- [Contributing](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/CONTRIBUTING.md): governance · Rules and boundary for adding or curating content. · `CONTRIBUTING.md`
- [Packages](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/Packages.md): setup guide · Environment and tooling reference for learners. · `Packages.md`
- [License](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/LICENSE): legal · Repository redistribution terms. · `LICENSE`
- **Brand asset**: media · Documentation image used in the README.

### Roadmaps

Structured learning paths across AI/ML subdomains.

- [Roadmaps](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/roadmaps): learning paths · Collection of domain-specific learning sequences. · `roadmaps`
- [Foundations](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ml-roadmap.md): roadmap · Core baseline for AI, data science, ML, and deep learning. · `roadmaps/ml-roadmap.md`
- [AI](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ai-roadmap.md): roadmap · Broad artificial intelligence orientation and concepts. · `roadmaps/ai-roadmap.md`
- [Data Science](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/data-science-roadmap.md): roadmap · Data analysis, statistics, and practical DS progression. · `roadmaps/data-science-roadmap.md`
- [ML](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ml-roadmap.md): roadmap · Machine learning methods, theory, and practice. · `roadmaps/ml-roadmap.md`
- [Deep Learning](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/deep-learning-roadmap.md): roadmap · Neural network foundations and modern DL workflow. · `roadmaps/deep-learning-roadmap.md`
- **Specializations**: roadmap cluster · Focused tracks built on the core foundations.
- [Computer Vision](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/computer-vision-roadmap.md): roadmap · Visual perception and image understanding track. · `roadmaps/computer-vision-roadmap.md`
- [NLP](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/nlp-roadmap.md): roadmap · Language understanding and text processing track. · `roadmaps/nlp-roadmap.md`
- [LLM](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/llm-roadmap.md): roadmap · Large language model concepts and ecosystems. · `roadmaps/llm-roadmap.md`
- [GenAI](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/generative-ai-roadmap.md): roadmap · Generative AI workflows and applications. · `roadmaps/generative-ai-roadmap.md`
- [RAG](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/rag-roadmap.md): roadmap · Retrieval-augmented generation and knowledge grounding. · `roadmaps/rag-roadmap.md`
- **Ops & Research**: roadmap cluster · Production, research, and safety-oriented tracks.
- [MLOps](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/mlops-production-ai-roadmap.md): roadmap · Production AI, deployment, and lifecycle management. · `roadmaps/mlops-production-ai-roadmap.md`
- [Research Scientist](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/research-scientist-roadmap.md): roadmap · Research workflow, reading, and experimentation track. · `roadmaps/research-scientist-roadmap.md`
- [AI Safety](https://github.com/bishwaghimire/ai-learning-roadmaps/blob/main/roadmaps/ai-safety-alignment-roadmap.md): roadmap · Alignment, safety, and responsible AI track. · `roadmaps/ai-safety-alignment-roadmap.md`

### Resources

Offline reference library of books and PDFs.

- [Resource library](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources): document store · Curated offline books and PDFs supporting the learning paths. · `resources`
- [Foundations books](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/foundations): resource set · Python and deep learning primers for the baseline layer. · `resources/foundations`
- [Data Science books](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/Data-Science): resource set · Math, statistics, SQL, and interview preparation materials. · `resources/Data-Science`
- [ML books](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/ML): resource set · Machine learning theory and implementation references. · `resources/ML`
- [DL books](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/DL): resource set · Deep learning reference material. · `resources/DL`
- [AI books](https://github.com/bishwaghimire/ai-learning-roadmaps/tree/main/resources/AI): resource set · General AI reference material. · `resources/AI`

### External sources

Outbound learning systems and communities linked from the repo.

- **External links**: outbound index · Third-party courses, papers, blogs, tools, and communities referenced by the repo.
- **Courses**: external source · MOOCs and lecture series such as MIT OCW and Coursera.
- **Papers**: external source · Research sources such as arXiv and related technical writing.
- **Platforms**: external source · Tool and ecosystem docs such as Hugging Face and major AI vendor blogs.
- **Communities**: external source · Discussion and support channels such as Reddit, Discord, Telegram, and Stack Overflow.

## Connections

- README → Roadmaps: starts here · Learners begin with the repo homepage and choose a path.
- README → Resource library: references · The homepage also points to curated books and PDFs.
- README → Packages: setup · Learners can consult environment and tooling guidance.
- README → Contributing: rules · Content additions and curation follow the contribution guide.
- README → External links: outbound · Navigation often routes users to outside learning systems.
- Roadmaps → Foundations: baseline · The foundational layer underpins the rest of the learning paths.
- Roadmaps → AI: domain · Broad AI orientation sits alongside the core baseline.
- Roadmaps → Data Science: domain · Data science is one of the primary entry paths.
- Roadmaps → ML: domain · Machine learning is a central track in the set.
- Roadmaps → Deep Learning: domain · Deep learning extends the core foundation layer.
- Roadmaps → Specializations: branches · Specialized tracks branch off from the common foundations.
- Specializations → Computer Vision: track · Computer vision is one specialization branch.
- Specializations → NLP: track · NLP is one specialization branch.
- Specializations → LLM: track · LLM learning is one specialization branch.
- Specializations → GenAI: track · Generative AI is one specialization branch.
- Specializations → RAG: track · RAG is one specialization branch.
- Roadmaps → Ops & Research: advanced paths · Production, research, and safety are separate advanced branches.
- Ops & Research → MLOps: track · MLOps covers production AI workflows.
- Ops & Research → Research Scientist: track · Research scientist guidance supports experimentation and reading.
- Ops & Research → AI Safety: track · AI safety and alignment form a distinct advanced path.
- Foundations → Foundations books: supported by · Baseline roadmap items are reinforced by foundational books.
- Data Science → Data Science books: supported by · Data science topics are backed by curated references.
- ML → ML books: supported by · Machine learning concepts link to deeper reading materials.
- Deep Learning → DL books: supported by · Deep learning concepts link to deep reference material.
- AI → AI books: supported by · General AI study is reinforced by reference texts.
- Resource library → Foundations books: contains · The resource library includes foundational materials.
- Resource library → Data Science books: contains · The resource library includes data science materials.
- Resource library → ML books: contains · The resource library includes machine learning materials.
- Resource library → DL books: contains · The resource library includes deep learning materials.
- Resource library → AI books: contains · The resource library includes general AI materials.
- External links → Courses: includes · Courseware and lecture links are part of the external index.
- External links → Papers: includes · Research papers and preprints are part of the external index.
- External links → Platforms: includes · Tooling and vendor ecosystems are part of the external index.
- External links → Communities: includes · Community and support channels are part of the external index.
