# ikmlab/nthu_natural_language_processing architecture

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

- Interactive diagram: https://gitdiagram.com/ikmlab/nthu_natural_language_processing
- Repository: https://github.com/ikmlab/nthu_natural_language_processing

## Overview

This is a repository of NTHU NLP course materials, not a runtime application. A learner’s main path is through weekly lecture topics and slides, with linked assignments for practice; reference notebooks and helper code provide additional tutorials. The README documents the weekly slide and homework links. The 2026 tree has no Assignment 4, and the sampled source does not establish how the RAG tutorial notebooks are wired, so those connections are not inferred.

Main entry points: [`README.md`](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/README.md) (Weekly topics), [`2026/Slides/W1_NLP_brief.pdf`](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W1_NLP_brief.pdf) (NLP introduction), [`2026/Slides/W2_Word embeddings and Language Modeling (RNN).pdf`](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W2_Word%20embeddings%20and%20Language%20Modeling%20(RNN).pdf) (Language models), [`2026/Slides/W3_Transformers.pdf`](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W3_Transformers.pdf) (Transformers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Course curriculum"]
  node_weekly_topics["Weekly topics<br/>[README.md]"]
  node_intro_slides["NLP introduction<br/>[W1_NLP_brief.pdf]"]
  node_language_slides["Language models"]
  node_transformer_slides["Transformers"]
  node_bert_slides["BERT"]
  node_decoding_slides["Decoding<br/>[W5_decoding.pdf]"]
  node_llm_slides["LLM training"]
  node_peft_slides["PEFT<br/>[W9_PEFT.pdf]"]
  node_rag_slides["RAG<br/>[W11_RAG.pdf]"]
  node_reasoning_slides["Reasoning"]
end

subgraph group_assignments["Course assignments"]
  node_assignment1["Word embeddings<br/>[main.ipynb]"]
  node_assignment2["Arithmetic modeling<br/>[main.ipynb]"]
  node_assignment3["Fact verification<br/>[sample_code.ipynb]"]
end

subgraph group_references["Reference tutorials"]
  node_api_tutorial["LLM API lab<br/>[llm_api.ipynb]"]
  node_prompt_loader["Prompt loader<br/>[utils.py]"]
  node_rag_tutorial["RAG tutorial"]
  node_rag_helpers["RAG retrieval helpers"]
  node_gpt_tutorial["GPT summarization"]
  node_t5_tutorial["T5 summarization"]
end

node_learner(("Learner"))

node_learner -->|"follows"| node_weekly_topics
node_weekly_topics -->|"links"| node_intro_slides
node_weekly_topics -->|"links"| node_language_slides
node_weekly_topics -->|"links"| node_transformer_slides
node_weekly_topics -->|"links"| node_bert_slides
node_weekly_topics -->|"links"| node_decoding_slides
node_weekly_topics -->|"links"| node_llm_slides
node_weekly_topics -->|"covers"| node_peft_slides
node_weekly_topics -->|"covers"| node_rag_slides
node_weekly_topics -->|"covers"| node_reasoning_slides
node_weekly_topics -->|"assigns"| node_assignment1
node_weekly_topics -->|"assigns"| node_assignment2
node_weekly_topics -->|"assigns"| node_assignment3
node_weekly_topics -->|"links"| node_gpt_tutorial
node_weekly_topics -->|"links"| node_t5_tutorial

click node_weekly_topics "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/README.md"
click node_intro_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W1_NLP_brief.pdf"
click node_language_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W2_Word%20embeddings%20and%20Language%20Modeling%20(RNN).pdf"
click node_transformer_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W3_Transformers.pdf"
click node_bert_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W4_bert_and_its_family_v2.pdf"
click node_decoding_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W5_decoding.pdf"
click node_llm_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W8_GPT3_InstructGPT_RLHF.pdf"
click node_peft_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W9_PEFT.pdf"
click node_rag_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W11_RAG.pdf"
click node_reasoning_slides "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/Note_from_Google_DeepMind's_Reasoning_Talk.pdf"
click node_assignment1 "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment1/main.ipynb"
click node_assignment2 "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment2/main.ipynb"
click node_assignment3 "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment3/sample_code.ipynb"
click node_api_tutorial "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/LLM_API_lab/llm_api.ipynb"
click node_prompt_loader "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/LLM_API_lab/utils.py"
click node_rag_tutorial "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/RAG_lab_2/RAG_tutorial_2.ipynb"
click node_rag_helpers "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/RAG_lab_2/helper_functions.py"
click node_gpt_tutorial "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/gpt2_summarization.ipynb"
click node_t5_tutorial "https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/t5_summarization.ipynb"

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_weekly_topics,node_intro_slides,node_language_slides,node_transformer_slides,node_bert_slides,node_decoding_slides,node_llm_slides,node_peft_slides,node_rag_slides,node_reasoning_slides toneBlue
class node_assignment1,node_assignment2,node_assignment3 toneAmber
class node_api_tutorial,node_prompt_loader,node_rag_tutorial,node_rag_helpers,node_gpt_tutorial,node_t5_tutorial toneMint
class node_learner toneIndigo
```

## Components

### Course curriculum

- [Weekly topics](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/README.md): `README.md`
- [NLP introduction](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W1_NLP_brief.pdf): `2026/Slides/W1_NLP_brief.pdf`
- [Language models](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W2_Word%20embeddings%20and%20Language%20Modeling%20(RNN).pdf): `2026/Slides/W2_Word embeddings and Language Modeling (RNN).pdf`
- [Transformers](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W3_Transformers.pdf): `2026/Slides/W3_Transformers.pdf`
- [BERT](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W4_bert_and_its_family_v2.pdf): `2026/Slides/W4_bert_and_its_family_v2.pdf`
- [Decoding](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W5_decoding.pdf): `2026/Slides/W5_decoding.pdf`
- [LLM training](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W8_GPT3_InstructGPT_RLHF.pdf): `2026/Slides/W8_GPT3_InstructGPT_RLHF.pdf`
- [PEFT](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W9_PEFT.pdf): `2026/Slides/W9_PEFT.pdf`
- [RAG](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/W11_RAG.pdf): `2026/Slides/W11_RAG.pdf`
- [Reasoning](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Slides/Note_from_Google_DeepMind's_Reasoning_Talk.pdf): `2026/Slides/Note_from_Google_DeepMind's_Reasoning_Talk.pdf`

### Course assignments

- [Word embeddings](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment1/main.ipynb): `2026/Assignments/Assignment1/main.ipynb`
- [Arithmetic modeling](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment2/main.ipynb): `2026/Assignments/Assignment2/main.ipynb`
- [Fact verification](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Assignments/Assignment3/sample_code.ipynb): `2026/Assignments/Assignment3/sample_code.ipynb`

### Reference tutorials

- [LLM API lab](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/LLM_API_lab/llm_api.ipynb): `2026/Reference/LLM_API_lab/llm_api.ipynb`
- [Prompt loader](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/LLM_API_lab/utils.py): `2026/Reference/LLM_API_lab/utils.py`
- [RAG tutorial](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/RAG_lab_2/RAG_tutorial_2.ipynb): `2026/Reference/RAG_lab_2/RAG_tutorial_2.ipynb`
- [RAG retrieval helpers](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/RAG_lab_2/helper_functions.py): `2026/Reference/RAG_lab_2/helper_functions.py`
- [GPT summarization](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/gpt2_summarization.ipynb): `2026/Reference/gpt2_summarization.ipynb`
- [T5 summarization](https://github.com/ikmlab/nthu_natural_language_processing/blob/main/2026/Reference/t5_summarization.ipynb): `2026/Reference/t5_summarization.ipynb`

### Other components

- **Learner**

## Connections

- Learner → Weekly topics: follows (evidence: `README.md`)
- Weekly topics → NLP introduction: links (evidence: `README.md`)
- Weekly topics → Language models: links (evidence: `README.md`)
- Weekly topics → Transformers: links (evidence: `README.md`)
- Weekly topics → BERT: links (evidence: `README.md`)
- Weekly topics → Decoding: links (evidence: `README.md`)
- Weekly topics → LLM training: links (evidence: `README.md`)
- Weekly topics → PEFT: covers (evidence: `README.md`)
- Weekly topics → RAG: covers (evidence: `README.md`)
- Weekly topics → Reasoning: covers (evidence: `README.md`)
- Weekly topics → Word embeddings: assigns (evidence: `README.md`)
- Weekly topics → Arithmetic modeling: assigns (evidence: `README.md`)
- Weekly topics → Fact verification: assigns (evidence: `README.md`)
- Weekly topics → GPT summarization: links (evidence: `README.md`)
- Weekly topics → T5 summarization: links (evidence: `README.md`)
