# mohamedezzeldeenhassanmohamed/nlp-projects-repository architecture

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

- Interactive diagram: https://gitdiagram.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository
- Repository: https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository

## Overview

This repository is a collection of independent NLP examples, datasets, and model solutions rather than one integrated application. Users choose a problem-specific notebook or script and work through its example; the clearest source-supported internal workflow is the attention-based translation example, which preprocesses parallel text, trains encoder/decoder components, saves checkpoints, and restores them for translation. Other README-promoted problem areas are represented as separate projects. Most notebooks and their relationships were not sampled, so their internal flows are omitted.

Main entry points: [`NMT using Attention and Transformers/Attention/preprocess_train.py`](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/preprocess_train.py) (Translation training), [`NMT using Attention and Transformers/Attention/utils/decoder.py`](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/decoder.py) (Decoder), [`NMT using Attention and Transformers/Attention/utils/encoder.py`](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/encoder.py) (Encoder), [`NMT using Attention and Transformers/Attention/inference.py`](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/inference.py) (Translation inference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_classification["Text Classification"]
  node_amazon["Review sentiment"]
  node_googleplay["App sentiment"]
  node_imdb["Movie sentiment"]
  node_toxic["Toxic comments<br/>[transformers.ipynb]"]
  node_multilabel["Multi-label text"]
  node_fake_news["Fake news model<br/>[fake_news_model.py]"]
  node_fake_recognition["Fake news recognition<br/>[recognition.py]"]
  node_spam["SMS spam<br/>[spam_classifier.py]"]
end

subgraph group_transformers["Transformer NLP"]
  node_transformer_scratch["Transformer from scratch"]
  node_fine_tune["BERT fine-tuning"]
  node_summarization["Text summarization"]
end

subgraph group_translation["Machine Translation"]
  node_nmt_data_train["Translation training"]
  node_nmt_inference["Translation inference<br/>[inference.py]"]
  node_encoder["Encoder<br/>[encoder.py]"]
  node_attention["Attention layer<br/>[attention.py]"]
  node_decoder["Decoder<br/>[decoder.py]"]
  node_seq2seq["Seq2seq translation<br/>[nmt_eng2spa.py]"]
end

subgraph group_preprocessing["Text Processing"]
  node_cleaning["Text cleaning"]
  node_vectorization["Text vectorization"]
  node_emoji_maps["Emoji mappings<br/>[emo_unicode.py]"]
end

subgraph group_other["Other NLP Examples"]
  node_rnn_example["Basic RNN<br/>[rnn.py]"]
  node_youtube["YouTube classifier<br/>[classifier.py]"]
  node_sentence_similarity["Sentence similarity"]
  node_ner["Named entity recognition<br/>[NER.ipynb]"]
end

node_user(("Project user"))

node_nmt_data_train -->|"calls"| node_encoder
node_nmt_data_train -->|"calls"| node_decoder
node_nmt_data_train -->|"instantiates"| node_attention
node_nmt_data_train -->|"trains"| node_encoder
node_nmt_data_train -->|"trains"| node_decoder
node_nmt_inference -->|"calls"| node_encoder
node_nmt_inference -->|"calls"| node_decoder
node_decoder -->|"calls"| node_attention

click node_amazon "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Amazon%20Review%20Sentiment%20Analysis/amazon_reviews_sentiment_classification.ipynb"
click node_googleplay "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/GooglePlay%20Sentiment%20Analysis/googleplay_sentiment_analysis.ipynb"
click node_imdb "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/IMDB%20Movies%20Sentiment%20Analysis/imdb_movies_sentiment_analysis_using_bert.ipynb"
click node_toxic "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Kaggle%20Toxic%20comments%20challenge%20using%20Hugging%20Face%20Transformers/transformers.ipynb"
click node_multilabel "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Multi-Label%20Text%20Classification/MultiLabel_Text_Classification.ipynb"
click node_fake_news "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Kaggle_fake_news_classifier/fake_news_model.py"
click node_fake_recognition "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Kaggle_fake_news_classifier/recognition.py"
click node_spam "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/basic_spam_classifier/spam_classifier.py"
click node_transformer_scratch "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Transformer%20from%20scratch/Transformers_using_PyTorch.ipynb"
click node_fine_tune "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Fine%20Tune%20BERT/fine_tuning_bert_with_MLM.ipynb"
click node_summarization "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Text%20Summarization%20using%20Transformers/transformers_text_summarization.ipynb"
click node_nmt_data_train "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/preprocess_train.py"
click node_nmt_inference "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/inference.py"
click node_encoder "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/encoder.py"
click node_attention "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/attention.py"
click node_decoder "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/decoder.py"
click node_seq2seq "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Neural%20Machine%20Translation%20using%20seq2seq%20model/nmt_eng2spa.py"
click node_cleaning "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/All_text_cleaning_techniques.ipynb"
click node_vectorization "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/Vectorization_techniques.ipynb"
click node_emoji_maps "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/emo_unicode.py"
click node_rnn_example "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/basic%20RNN%20example/rnn.py"
click node_youtube "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/youtube%20channel%20classifier/classifier.py"
click node_sentence_similarity "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Sentence%20Similarity/sentence_similarity_using_BERT.ipynb"
click node_ner "https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Named%20Entity%20Recognition/NER.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_amazon,node_googleplay,node_imdb,node_toxic,node_multilabel,node_fake_news,node_fake_recognition,node_spam,node_user toneBlue
class node_transformer_scratch,node_fine_tune,node_summarization toneAmber
class node_nmt_data_train,node_nmt_inference,node_encoder,node_attention,node_decoder,node_seq2seq toneMint
class node_cleaning,node_vectorization,node_emoji_maps toneRose
class node_rnn_example,node_youtube,node_sentence_similarity,node_ner toneIndigo
```

## Components

### Text Classification

- [Review sentiment](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Amazon%20Review%20Sentiment%20Analysis/amazon_reviews_sentiment_classification.ipynb): `BERT/Amazon Review Sentiment Analysis/amazon_reviews_sentiment_classification.ipynb`
- [App sentiment](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/GooglePlay%20Sentiment%20Analysis/googleplay_sentiment_analysis.ipynb): `BERT/GooglePlay Sentiment Analysis/googleplay_sentiment_analysis.ipynb`
- [Movie sentiment](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/IMDB%20Movies%20Sentiment%20Analysis/imdb_movies_sentiment_analysis_using_bert.ipynb): `BERT/IMDB Movies Sentiment Analysis/imdb_movies_sentiment_analysis_using_bert.ipynb`
- [Toxic comments](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Kaggle%20Toxic%20comments%20challenge%20using%20Hugging%20Face%20Transformers/transformers.ipynb): `BERT/Kaggle Toxic comments challenge using Hugging Face Transformers/transformers.ipynb`
- [Multi-label text](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Multi-Label%20Text%20Classification/MultiLabel_Text_Classification.ipynb): `Multi-Label Text Classification/MultiLabel_Text_Classification.ipynb`
- [Fake news model](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Kaggle_fake_news_classifier/fake_news_model.py): `Kaggle_fake_news_classifier/fake_news_model.py`
- [Fake news recognition](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Kaggle_fake_news_classifier/recognition.py): `Kaggle_fake_news_classifier/recognition.py`
- [SMS spam](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/basic_spam_classifier/spam_classifier.py): `basic_spam_classifier/spam_classifier.py`

### Transformer NLP

- [Transformer from scratch](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Transformer%20from%20scratch/Transformers_using_PyTorch.ipynb): `BERT/Transformer from scratch/Transformers_using_PyTorch.ipynb`
- [BERT fine-tuning](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Fine%20Tune%20BERT/fine_tuning_bert_with_MLM.ipynb): `BERT/Fine Tune BERT/fine_tuning_bert_with_MLM.ipynb`
- [Text summarization](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Text%20Summarization%20using%20Transformers/transformers_text_summarization.ipynb): `Text Summarization using Transformers/transformers_text_summarization.ipynb`

### Machine Translation

- [Translation training](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/preprocess_train.py): `NMT using Attention and Transformers/Attention/preprocess_train.py`
- [Translation inference](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/inference.py): `NMT using Attention and Transformers/Attention/inference.py`
- [Encoder](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/encoder.py): `NMT using Attention and Transformers/Attention/utils/encoder.py`
- [Attention layer](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/attention.py): `NMT using Attention and Transformers/Attention/utils/attention.py`
- [Decoder](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/NMT%20using%20Attention%20and%20Transformers/Attention/utils/decoder.py): `NMT using Attention and Transformers/Attention/utils/decoder.py`
- [Seq2seq translation](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Neural%20Machine%20Translation%20using%20seq2seq%20model/nmt_eng2spa.py): `Neural Machine Translation using seq2seq model/nmt_eng2spa.py`

### Text Processing

- [Text cleaning](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/All_text_cleaning_techniques.ipynb): `PREPROCESSING TECHNIQUES/All_text_cleaning_techniques.ipynb`
- [Text vectorization](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/Vectorization_techniques.ipynb): `PREPROCESSING TECHNIQUES/Vectorization_techniques.ipynb`
- [Emoji mappings](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/PREPROCESSING%20TECHNIQUES/emo_unicode.py): `PREPROCESSING TECHNIQUES/emo_unicode.py`

### Other NLP Examples

- [Basic RNN](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/basic%20RNN%20example/rnn.py): `basic RNN example/rnn.py`
- [YouTube classifier](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/youtube%20channel%20classifier/classifier.py): `youtube channel classifier/classifier.py`
- [Sentence similarity](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/BERT/Sentence%20Similarity/sentence_similarity_using_BERT.ipynb): `BERT/Sentence Similarity/sentence_similarity_using_BERT.ipynb`
- [Named entity recognition](https://github.com/mohamedezzeldeenhassanmohamed/nlp-projects-repository/blob/main/Named%20Entity%20Recognition/NER.ipynb): `Named Entity Recognition/NER.ipynb`

### Other components

- **Project user**

## Connections

- Translation training → Encoder: calls (evidence: `NMT using Attention and Transformers/Attention/preprocess_train.py`)
- Translation training → Decoder: calls (evidence: `NMT using Attention and Transformers/Attention/preprocess_train.py`)
- Translation training → Attention layer: instantiates (evidence: `NMT using Attention and Transformers/Attention/preprocess_train.py`)
- Translation training → Encoder: trains (evidence: `NMT using Attention and Transformers/Attention/preprocess_train.py`)
- Translation training → Decoder: trains (evidence: `NMT using Attention and Transformers/Attention/preprocess_train.py`)
- Translation inference → Encoder: calls (evidence: `NMT using Attention and Transformers/Attention/inference.py`)
- Translation inference → Decoder: calls (evidence: `NMT using Attention and Transformers/Attention/inference.py`)
- Decoder → Attention layer: calls (evidence: `NMT using Attention and Transformers/Attention/utils/decoder.py`)
