# gunalgupta/academic-plagiarism-checker---for-handwritten-submissions architecture

> Architecture diagram of the GitHub repository gunalgupta/academic-plagiarism-checker---for-handwritten-submissions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions
- Repository: https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions

## Overview

This is a Streamlit application for checking handwritten assignment submissions for plagiarism. A user uploads a ZIP archive and starts a scan; the app extracts the submissions and invokes the comparison workflow, which combines image-pattern similarity with OCR text embeddings and reports complete or potential matches. An optional Level 4 branch asks OpenAI to assess paraphrasing. The graph reflects the shown calls and README-described capabilities; it does not infer additional wiring for unsampled behavior.

Main entry points: [`model.py`](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py) (Pairwise scanner), [`streamlit.py`](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/streamlit.py) (Streamlit app), [`ocr.py`](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/ocr.py) (OCR extraction), [`openai_model.py`](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/openai_model.py) (Paraphrase check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Upload interface"]
  node_archive["Submission ZIP"]
  node_app["Streamlit app<br/>[streamlit.py]"]
  node_extraction["Archive extraction<br/>[streamlit.py]"]
  node_submissions["Submission files"]
end

subgraph group_analysis["Plagiarism analysis"]
  node_scanner["Pairwise scanner<br/>[model.py]"]
  node_udp["HOG patterns<br/>[udp.py]"]
  node_textcompare["Text similarity<br/>[model.py]"]
  node_results["Match results<br/>[model.py]"]
end

subgraph group_integrations["External services"]
  node_ocr["OCR extraction<br/>[ocr.py]"]
  node_ocrservice["OCR API"]
  node_paraphrase["Paraphrase check<br/>[openai_model.py]"]
  node_openai["OpenAI service"]
end

node_user(("Instructor"))

node_user -->|"uploads and starts"| node_app
node_app -->|"accepts ZIP"| node_archive
node_app -->|"validates and extracts"| node_extraction
node_extraction -->|"produces files"| node_submissions
node_app -->|"invokes scan"| node_scanner
node_scanner -->|"reads files"| node_submissions
node_scanner -->|"extracts text"| node_ocr
node_ocr -->|"sends image"| node_ocrservice
node_scanner -->|"compares patterns"| node_udp
node_scanner -->|"scores text embeddings"| node_textcompare
node_scanner -->|"optionally checks paraphrases"| node_paraphrase
node_paraphrase -->|"requests comparison"| node_openai
node_scanner -->|"reports match pairs"| node_results
node_results -->|"displays results"| node_app

click node_app "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/streamlit.py"
click node_extraction "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/streamlit.py"
click node_scanner "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py"
click node_udp "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/udp.py"
click node_ocr "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/ocr.py"
click node_textcompare "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py"
click node_paraphrase "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/openai_model.py"
click node_results "https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py"

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_archive,node_app,node_extraction,node_submissions toneBlue
class node_scanner,node_udp,node_textcompare,node_results toneAmber
class node_ocr,node_ocrservice,node_paraphrase,node_openai toneMint
class node_user toneIndigo
```

## Components

### Upload interface

- **Submission ZIP**
- [Streamlit app](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/streamlit.py): `streamlit.py`
- [Archive extraction](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/streamlit.py): `streamlit.py`
- **Submission files**

### Plagiarism analysis

- [Pairwise scanner](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py): `model.py`
- [HOG patterns](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/udp.py): `udp.py`
- [Text similarity](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py): `model.py`
- [Match results](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/model.py): `model.py`

### External services

- [OCR extraction](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/ocr.py): `ocr.py`
- **OCR API**
- [Paraphrase check](https://github.com/gunalgupta/academic-plagiarism-checker---for-handwritten-submissions/blob/main/openai_model.py): `openai_model.py`
- **OpenAI service**

### Other components

- **Instructor**

## Connections

- Instructor → Streamlit app: uploads and starts (evidence: `README.md`)
- Streamlit app → Submission ZIP: accepts ZIP (evidence: `streamlit.py`)
- Streamlit app → Archive extraction: validates and extracts (evidence: `streamlit.py`)
- Archive extraction → Submission files: produces files (evidence: `streamlit.py`)
- Streamlit app → Pairwise scanner: invokes scan (evidence: `streamlit.py`)
- Pairwise scanner → Submission files: reads files (evidence: `model.py`)
- Pairwise scanner → OCR extraction: extracts text (evidence: `model.py`)
- OCR extraction → OCR API: sends image (evidence: `ocr.py`)
- Pairwise scanner → HOG patterns: compares patterns (evidence: `model.py`)
- Pairwise scanner → Text similarity: scores text embeddings (evidence: `model.py`)
- Pairwise scanner → Paraphrase check: optionally checks paraphrases (evidence: `model.py`)
- Paraphrase check → OpenAI service: requests comparison (evidence: `openai_model.py`)
- Pairwise scanner → Match results: reports match pairs (evidence: `model.py`)
- Match results → Streamlit app: displays results (evidence: `model.py`)
