# thiru-selvam-06/deepfake-detection architecture

> Architecture diagram of the GitHub repository thiru-selvam-06/deepfake-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thiru-selvam-06/deepfake-detection
- Repository: https://github.com/thiru-selvam-06/deepfake-detection

## Overview

Deepfake Detection accepts image and video uploads and returns REAL/FAKE predictions with confidence. The root Flask app serves the React interface and exposes image and video detection; its documented video workflow samples frames, detects faces, applies a ResNeXt-50 + LSTM model, and aggregates results. A separate packaged Flask API provides a ViT image-classification workflow with validation, face analysis, quality checks, and review decisions, plus a pilot assisted-triage API and telemetry. Source excerpts chiefly cover the packaged image API and parts of the root server; video-stage links follow the README, and unsampled internals are not inferred.

Main entry points: [`deepfake-detector-model-v1-main/src/pilot_api.py`](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_api.py) (Pilot API), [`server.py`](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py) (Flask Web Server), [`deepfake-detector-model-v1-main/src/api.py`](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/api.py) (Image API), [`deepfake-detector-model-v1-main/src/pipeline.py`](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pipeline.py) (Face Analysis Pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Experience"]
  node_frontend["React Interface"]
end

subgraph group_root["Root Detection App"]
  node_root_server["Flask Web Server<br/>[server.py]"]
  node_video_pipeline["Video Pipeline<br/>[server.py]"]
  node_video_model["ResNeXt LSTM<br/>[server.py]"]
  node_video_weights["Video Weights<br/>[df_model.pt]"]
  node_image_pipeline["Image Inference<br/>[pilot_pipeline.py]"]
end

subgraph group_package["Packaged Image API"]
  node_packaged_app["Packaged App<br/>[app.py]"]
  node_image_api["Image API<br/>[api.py]"]
  node_validators["Upload Validation<br/>[validators.py]"]
  node_pipeline["Face Analysis Pipeline<br/>[pipeline.py]"]
  node_face_detector["Face Detection<br/>[face_detector.py]"]
  node_quality["Image Quality<br/>[quality.py]"]
  node_model_wrapper["ViT Model<br/>[model_wrapper.py]"]
  node_config["Pipeline Configuration<br/>[config.py]"]
end

subgraph group_pilot["Pilot Triage"]
  node_pilot_api["Pilot API<br/>[pilot_api.py]"]
  node_pilot_pipeline["Pilot Pipeline<br/>[pilot_pipeline.py]"]
  node_telemetry["Review Telemetry<br/>[pilot_telemetry.py]"]
end

node_user(("Media User"))
node_reviewer(("Human Reviewer"))

node_user -->|"uploads media"| node_frontend
node_frontend -.->|"submits upload"| node_root_server
node_root_server -->|"serves interface"| node_frontend
node_root_server -->|"routes video"| node_video_pipeline
node_video_pipeline -->|"classifies sequences"| node_video_model
node_video_model -.->|"loads weights"| node_video_weights
node_root_server -->|"calls image inference"| node_image_pipeline
node_user -.->|"submits image"| node_packaged_app
node_packaged_app -->|"creates API"| node_image_api
node_image_api -->|"validates upload"| node_validators
node_image_api -->|"processes image"| node_pipeline
node_pipeline -->|"detects faces"| node_face_detector
node_pipeline -->|"assesses quality"| node_quality
node_pipeline -->|"runs inference"| node_model_wrapper
node_image_api -->|"registers blueprint"| node_pilot_api
node_pilot_api -->|"validates upload"| node_validators
node_pilot_api -->|"runs pilot inference"| node_pilot_pipeline
node_pilot_api -->|"logs inference"| node_telemetry
node_reviewer -->|"submits review"| node_pilot_api
node_pilot_api -->|"records review"| node_telemetry

click node_frontend "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/static/react/js/main.ecd30300.chunk.js"
click node_root_server "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py"
click node_video_pipeline "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py"
click node_video_model "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py"
click node_video_weights "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/model/df_model.pt"
click node_image_pipeline "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_pipeline.py"
click node_packaged_app "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/app.py"
click node_image_api "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/api.py"
click node_validators "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/validators.py"
click node_pipeline "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pipeline.py"
click node_face_detector "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/face_detector.py"
click node_quality "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/quality.py"
click node_model_wrapper "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/model_wrapper.py"
click node_config "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/config.py"
click node_pilot_api "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_api.py"
click node_pilot_pipeline "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_pipeline.py"
click node_telemetry "https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_telemetry.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_frontend,node_user,node_reviewer toneBlue
class node_root_server,node_video_pipeline,node_video_model,node_video_weights,node_image_pipeline toneAmber
class node_packaged_app,node_image_api,node_validators,node_pipeline,node_face_detector,node_quality,node_model_wrapper,node_config toneMint
class node_pilot_api,node_pilot_pipeline,node_telemetry toneRose
```

## Components

### Web Experience

- [React Interface](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/static/react/js/main.ecd30300.chunk.js): `static/react/js/main.ecd30300.chunk.js`

### Root Detection App

- [Flask Web Server](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py): `server.py`
- [Video Pipeline](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py): `server.py`
- [ResNeXt LSTM](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/server.py): `server.py`
- [Video Weights](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/model/df_model.pt): `model/df_model.pt`
- [Image Inference](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_pipeline.py): `deepfake-detector-model-v1-main/src/pilot_pipeline.py`

### Packaged Image API

- [Packaged App](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/app.py): `deepfake-detector-model-v1-main/app.py`
- [Image API](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/api.py): `deepfake-detector-model-v1-main/src/api.py`
- [Upload Validation](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/validators.py): `deepfake-detector-model-v1-main/src/validators.py`
- [Face Analysis Pipeline](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pipeline.py): `deepfake-detector-model-v1-main/src/pipeline.py`
- [Face Detection](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/face_detector.py): `deepfake-detector-model-v1-main/src/face_detector.py`
- [Image Quality](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/quality.py): `deepfake-detector-model-v1-main/src/quality.py`
- [ViT Model](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/model_wrapper.py): `deepfake-detector-model-v1-main/src/model_wrapper.py`
- [Pipeline Configuration](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/config.py): `deepfake-detector-model-v1-main/src/config.py`

### Pilot Triage

- [Pilot API](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_api.py): `deepfake-detector-model-v1-main/src/pilot_api.py`
- [Pilot Pipeline](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_pipeline.py): `deepfake-detector-model-v1-main/src/pilot_pipeline.py`
- [Review Telemetry](https://github.com/thiru-selvam-06/deepfake-detection/blob/main/deepfake-detector-model-v1-main/src/pilot_telemetry.py): `deepfake-detector-model-v1-main/src/pilot_telemetry.py`

### Other components

- **Media User**
- **Human Reviewer**

## Connections

- Media User → React Interface: uploads media (evidence: `README.md`)
- React Interface → Flask Web Server: submits upload
- Flask Web Server → React Interface: serves interface (evidence: `server.py`)
- Flask Web Server → Video Pipeline: routes video (evidence: `README.md`)
- Video Pipeline → ResNeXt LSTM: classifies sequences (evidence: `README.md`)
- ResNeXt LSTM → Video Weights: loads weights
- Flask Web Server → Image Inference: calls image inference (evidence: `server.py`)
- Media User → Packaged App: submits image
- Packaged App → Image API: creates API (evidence: `deepfake-detector-model-v1-main/app.py`)
- Image API → Upload Validation: validates upload (evidence: `deepfake-detector-model-v1-main/src/api.py`)
- Image API → Face Analysis Pipeline: processes image (evidence: `deepfake-detector-model-v1-main/src/api.py`)
- Face Analysis Pipeline → Face Detection: detects faces (evidence: `deepfake-detector-model-v1-main/src/pipeline.py`)
- Face Analysis Pipeline → Image Quality: assesses quality (evidence: `deepfake-detector-model-v1-main/src/pipeline.py`)
- Face Analysis Pipeline → ViT Model: runs inference (evidence: `deepfake-detector-model-v1-main/src/pipeline.py`)
- Image API → Pilot API: registers blueprint (evidence: `deepfake-detector-model-v1-main/src/api.py`)
- Pilot API → Upload Validation: validates upload (evidence: `deepfake-detector-model-v1-main/src/pilot_api.py`)
- Pilot API → Pilot Pipeline: runs pilot inference (evidence: `deepfake-detector-model-v1-main/src/pilot_api.py`)
- Pilot API → Review Telemetry: logs inference (evidence: `deepfake-detector-model-v1-main/src/pilot_api.py`)
- Human Reviewer → Pilot API: submits review (evidence: `deepfake-detector-model-v1-main/src/pilot_api.py`)
- Pilot API → Review Telemetry: records review (evidence: `deepfake-detector-model-v1-main/src/pilot_api.py`)
