# engrtarun/t_dubber architecture

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

- Interactive diagram: https://gitdiagram.com/engrtarun/t_dubber
- Repository: https://github.com/engrtarun/t_dubber

## Overview

Tarun Dubber AI is a Gradio control panel for submitting a video to a Kaggle GPU worker and presenting the downloaded dubbed video and report. The principal flow is upload and project persistence, Kaggle dataset creation/upload, worker dispatch and polling, then output download and display; project history provides a separate browsing capability. The repository also includes a standalone Telegram backup helper, but no shown caller connects it to the dubbing workflow. The worker notebook is documented by pipeline.py as the submitted execution code; its internal processing is not available in the sampled source.

Main entry points: [`pipeline.py`](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py) (Pipeline coordinator), [`projects`](https://github.com/engrtarun/t_dubber/tree/main/projects) (Project files), [`app.py`](https://github.com/engrtarun/t_dubber/blob/main/app.py) (Gradio control panel), [`telegram_backup.py`](https://github.com/engrtarun/t_dubber/blob/main/telegram_backup.py) (Telegram backup helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Studio interface"]
  node_gradio["Gradio control panel<br/>[app.py]"]
  node_project_setup["Project setup<br/>[app.py]"]
  node_history["Project history<br/>[app.py]"]
  node_metrics["Report metrics<br/>[app.py]"]
end

subgraph group_orchestration["Cloud orchestration"]
  node_pipeline["Pipeline coordinator<br/>[pipeline.py]"]
  node_dataset_prep["Dataset preparation<br/>[pipeline.py]"]
  node_kernel_dispatch["Worker dispatch<br/>[pipeline.py]"]
  node_worker_poll["Worker polling<br/>[pipeline.py]"]
  node_output_download["Output retrieval<br/>[pipeline.py]"]
end

subgraph group_artifacts["Project artifacts"]
  node_project_files["Project files"]
  node_worker_notebook["Kaggle worker notebook"]
  node_report_json["Quality report"]
end

subgraph group_integrations["External services"]
  node_kaggle_cli["Kaggle CLI"]
  node_kaggle_gpu["Kaggle GPU"]
  node_telegram_helper["Telegram backup helper<br/>[telegram_backup.py]"]
  node_telegram_api["Telegram API"]
end

node_user(("Video uploader"))

node_user -->|"uploads video"| node_gradio
node_gradio -->|"starts dubbing"| node_project_setup
node_project_setup -->|"persists video"| node_project_files
node_project_setup -->|"calls pipeline"| node_pipeline
node_pipeline -->|"prepares upload"| node_dataset_prep
node_dataset_prep -->|"writes dataset"| node_project_files
node_pipeline -->|"runs commands"| node_kaggle_cli
node_dataset_prep -->|"creates dataset"| node_kaggle_cli
node_pipeline -->|"pushes worker"| node_kernel_dispatch
node_kernel_dispatch -->|"copies notebook"| node_worker_notebook
node_kernel_dispatch -->|"pushes kernel"| node_kaggle_cli
node_worker_poll -->|"checks status"| node_kaggle_cli
node_pipeline -->|"waits for completion"| node_worker_poll
node_kaggle_gpu -.->|"produces outputs"| node_project_files
node_pipeline -->|"downloads outputs"| node_output_download
node_output_download -->|"requests output"| node_kaggle_cli
node_output_download -->|"saves artifacts"| node_project_files
node_gradio -->|"loads projects"| node_history
node_history -->|"reads files"| node_project_files
node_gradio -->|"renders report"| node_metrics
node_metrics -->|"reads report"| node_report_json
node_telegram_helper -->|"sends requests"| node_telegram_api

click node_gradio "https://github.com/engrtarun/t_dubber/blob/main/app.py"
click node_project_setup "https://github.com/engrtarun/t_dubber/blob/main/app.py"
click node_history "https://github.com/engrtarun/t_dubber/blob/main/app.py"
click node_metrics "https://github.com/engrtarun/t_dubber/blob/main/app.py"
click node_pipeline "https://github.com/engrtarun/t_dubber/blob/main/pipeline.py"
click node_dataset_prep "https://github.com/engrtarun/t_dubber/blob/main/pipeline.py"
click node_kernel_dispatch "https://github.com/engrtarun/t_dubber/blob/main/pipeline.py"
click node_worker_poll "https://github.com/engrtarun/t_dubber/blob/main/pipeline.py"
click node_output_download "https://github.com/engrtarun/t_dubber/blob/main/pipeline.py"
click node_project_files "https://github.com/engrtarun/t_dubber/tree/main/projects"
click node_worker_notebook "https://github.com/engrtarun/t_dubber/blob/main/kaggle_worker.ipynb"
click node_report_json "https://github.com/engrtarun/t_dubber/tree/main/projects"
click node_telegram_helper "https://github.com/engrtarun/t_dubber/blob/main/telegram_backup.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_gradio,node_project_setup,node_history,node_metrics toneBlue
class node_pipeline,node_dataset_prep,node_kernel_dispatch,node_worker_poll,node_output_download toneAmber
class node_project_files,node_worker_notebook,node_report_json toneMint
class node_kaggle_cli,node_kaggle_gpu,node_telegram_helper,node_telegram_api toneRose
class node_user toneIndigo
```

## Components

### Studio interface

- [Gradio control panel](https://github.com/engrtarun/t_dubber/blob/main/app.py): `app.py`
- [Project setup](https://github.com/engrtarun/t_dubber/blob/main/app.py): `app.py`
- [Project history](https://github.com/engrtarun/t_dubber/blob/main/app.py): `app.py`
- [Report metrics](https://github.com/engrtarun/t_dubber/blob/main/app.py): `app.py`

### Cloud orchestration

- [Pipeline coordinator](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py): `pipeline.py`
- [Dataset preparation](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py): `pipeline.py`
- [Worker dispatch](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py): `pipeline.py`
- [Worker polling](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py): `pipeline.py`
- [Output retrieval](https://github.com/engrtarun/t_dubber/blob/main/pipeline.py): `pipeline.py`

### Project artifacts

- [Project files](https://github.com/engrtarun/t_dubber/tree/main/projects): `projects`
- [Kaggle worker notebook](https://github.com/engrtarun/t_dubber/blob/main/kaggle_worker.ipynb): `kaggle_worker.ipynb`
- [Quality report](https://github.com/engrtarun/t_dubber/tree/main/projects): `projects`

### External services

- **Kaggle CLI**
- **Kaggle GPU**
- [Telegram backup helper](https://github.com/engrtarun/t_dubber/blob/main/telegram_backup.py): `telegram_backup.py`
- **Telegram API**

### Other components

- **Video uploader**

## Connections

- Video uploader → Gradio control panel: uploads video (evidence: `app.py`)
- Gradio control panel → Project setup: starts dubbing (evidence: `app.py`)
- Project setup → Project files: persists video (evidence: `app.py`)
- Project setup → Pipeline coordinator: calls pipeline (evidence: `app.py`)
- Pipeline coordinator → Dataset preparation: prepares upload (evidence: `pipeline.py`)
- Dataset preparation → Project files: writes dataset (evidence: `pipeline.py`)
- Pipeline coordinator → Kaggle CLI: runs commands (evidence: `pipeline.py`)
- Dataset preparation → Kaggle CLI: creates dataset (evidence: `pipeline.py`)
- Pipeline coordinator → Worker dispatch: pushes worker (evidence: `pipeline.py`)
- Worker dispatch → Kaggle worker notebook: copies notebook (evidence: `pipeline.py`)
- Worker dispatch → Kaggle CLI: pushes kernel (evidence: `pipeline.py`)
- Worker polling → Kaggle CLI: checks status (evidence: `pipeline.py`)
- Pipeline coordinator → Worker polling: waits for completion (evidence: `pipeline.py`)
- Kaggle GPU → Project files: produces outputs
- Pipeline coordinator → Output retrieval: downloads outputs (evidence: `pipeline.py`)
- Output retrieval → Kaggle CLI: requests output (evidence: `pipeline.py`)
- Output retrieval → Project files: saves artifacts (evidence: `pipeline.py`)
- Gradio control panel → Project history: loads projects (evidence: `app.py`)
- Project history → Project files: reads files (evidence: `app.py`)
- Gradio control panel → Report metrics: renders report (evidence: `app.py`)
- Report metrics → Quality report: reads report (evidence: `app.py`)
- Telegram backup helper → Telegram API: sends requests (evidence: `telegram_backup.py`)
