# benguerine/neural-machine-translation-system architecture

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

- Interactive diagram: https://gitdiagram.com/benguerine/neural-machine-translation-system
- Repository: https://github.com/benguerine/neural-machine-translation-system

## Overview

This is a Gradio-based NLLB-200 translation application. Users submit text, speech, batches, or translation pairs for BLEU evaluation; the UI dispatches to package functions and displays translation or evaluation results. The graph separates interface, translation/model inference, language and speech handling, and evaluation. Edges reflect the app excerpt, source-index references, or README; unsampled wiring is not inferred.

Main entry points: [`app.py`](https://github.com/benguerine/neural-machine-translation-system/blob/main/app.py) (Gradio app), [`src/ai_translator/translate.py`](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/translate.py) (Text translation), [`src/ai_translator/speech.py`](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/speech.py) (Audio transcription), [`src/ai_translator/model.py`](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/model.py) (NLLB model loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_ui["Gradio app<br/>[app.py]"]
end

subgraph group_translation["Translation inference"]
  node_single["Text translation<br/>[translate.py]"]
  node_batch["Batch translation<br/>[translate.py]"]
  node_model["NLLB model loader<br/>[model.py]"]
  node_config["Model configuration<br/>[config.yml]"]
  node_languages["Language codes<br/>[languages.py]"]
end

subgraph group_speech["Speech processing"]
  node_speech["Audio transcription<br/>[speech.py]"]
  node_recognition["Google recognition"]
end

subgraph group_evaluation["Evaluation"]
  node_bleu["BLEU evaluation<br/>[evaluate.py]"]
end

node_user(("User"))
node_audio(("Audio input"))

node_user -->|"submits input"| node_ui
node_ui -->|"dispatches translation"| node_single
node_ui -->|"dispatches batch"| node_batch
node_ui -->|"requests transcription"| node_speech
node_speech -->|"returns transcript"| node_ui
node_ui -->|"requests scoring"| node_bleu
node_single -->|"loads model"| node_model
node_batch -->|"loads model"| node_model
node_single -->|"maps language codes"| node_languages
node_batch -->|"maps language codes"| node_languages
node_speech -->|"maps speech code"| node_languages
node_model -->|"reads settings"| node_config
node_single -->|"reads inference settings"| node_config
node_audio -->|"provides recording"| node_ui
node_speech -->|"sends audio for recognition"| node_recognition

click node_ui "https://github.com/benguerine/neural-machine-translation-system/blob/main/app.py"
click node_single "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/translate.py"
click node_batch "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/translate.py"
click node_model "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/model.py"
click node_config "https://github.com/benguerine/neural-machine-translation-system/blob/main/config.yml"
click node_languages "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/languages.py"
click node_speech "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/speech.py"
click node_bleu "https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/evaluate.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_ui,node_user toneBlue
class node_single,node_batch,node_model,node_config,node_languages toneAmber
class node_speech,node_recognition toneMint
class node_bleu toneRose
class node_audio toneIndigo
```

## Components

### User interface

- [Gradio app](https://github.com/benguerine/neural-machine-translation-system/blob/main/app.py): `app.py`

### Translation inference

- [Text translation](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/translate.py): `src/ai_translator/translate.py`
- [Batch translation](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/translate.py): `src/ai_translator/translate.py`
- [NLLB model loader](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/model.py): `src/ai_translator/model.py`
- [Model configuration](https://github.com/benguerine/neural-machine-translation-system/blob/main/config.yml): `config.yml`
- [Language codes](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/languages.py): `src/ai_translator/languages.py`

### Speech processing

- [Audio transcription](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/speech.py): `src/ai_translator/speech.py`
- **Google recognition**

### Evaluation

- [BLEU evaluation](https://github.com/benguerine/neural-machine-translation-system/blob/main/src/ai_translator/evaluate.py): `src/ai_translator/evaluate.py`

### Other components

- **User**
- **Audio input**

## Connections

- User → Gradio app: submits input (evidence: `README.md`)
- Gradio app → Text translation: dispatches translation (evidence: `app.py`)
- Gradio app → Batch translation: dispatches batch (evidence: `app.py`)
- Gradio app → Audio transcription: requests transcription (evidence: `app.py`)
- Audio transcription → Gradio app: returns transcript (evidence: `app.py`)
- Gradio app → BLEU evaluation: requests scoring (evidence: `app.py`)
- Text translation → NLLB model loader: loads model (evidence: `src/ai_translator/translate.py`)
- Batch translation → NLLB model loader: loads model (evidence: `src/ai_translator/translate.py`)
- Text translation → Language codes: maps language codes (evidence: `src/ai_translator/translate.py`)
- Batch translation → Language codes: maps language codes (evidence: `src/ai_translator/translate.py`)
- Audio transcription → Language codes: maps speech code (evidence: `src/ai_translator/speech.py`)
- NLLB model loader → Model configuration: reads settings (evidence: `src/ai_translator/model.py`)
- Text translation → Model configuration: reads inference settings (evidence: `src/ai_translator/translate.py`)
- Audio input → Gradio app: provides recording (evidence: `README.md`)
- Audio transcription → Google recognition: sends audio for recognition (evidence: `src/ai_translator/speech.py`)
