# ojas-k070/poliemotifusion architecture

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

- Interactive diagram: https://gitdiagram.com/ojas-k070/poliemotifusion
- Repository: https://github.com/ojas-k070/poliemotifusion

## Overview

PoliEmotiFusion is a multimodal political-content emotion analysis platform. Its most complete user-to-result path is text submission, political-content screening, and seven-class emotion inference; image analysis has a political-content gate and experimental scene-emotion scoring, while audio supports multilingual transcription and translation. The UI also exposes video, history, insights, settings, and architecture views, though the README describes several as planned or design-stage capabilities. Some frontend/backend links and unsampled route internals are documented only at a high level, so those relationships are not asserted as verified calls.

Main entry points: [`backend/main.py`](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/main.py) (FastAPI Endpoints), [`backend/speech_intelligence/pipeline.py`](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/pipeline.py) (Speech Pipeline), [`frontend/src/routes/index.tsx`](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/index.tsx) (Dashboard), [`backend/speech_intelligence/translation_service.py`](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/translation_service.py) (Speech Translation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User Interface"]
  node_dashboard["Dashboard<br/>[index.tsx]"]
  node_text_ui["Text Analysis<br/>[text.tsx]"]
  node_image_ui["Image Analysis<br/>[image.tsx]"]
  node_audio_ui["Audio Analysis<br/>[audio.tsx]"]
  node_video_ui["Video Analysis<br/>[video.tsx]"]
  node_history_ui["Analysis History<br/>[history.tsx]"]
  node_insights_ui["Insights<br/>[insights.tsx]"]
  node_settings_ui["Settings<br/>[settings.tsx]"]
  node_analysis_service["Analysis Client<br/>[analysisService.ts]"]
end

subgraph group_api["API Orchestration"]
  node_api["FastAPI Endpoints<br/>[main.py]"]
  node_schemas["Request and Result Schemas<br/>[schemas.py]"]
end

subgraph group_text_image["Text and Image Analysis"]
  node_political_gate["Text Political Gate"]
  node_text_emotion["Text Emotion Model<br/>[model_service.py]"]
  node_image_analysis["Image Gate and Scoring"]
  node_image_config["Image Model Configuration<br/>[image_config.py]"]
end

subgraph group_speech["Speech Intelligence"]
  node_speech_pipeline["Speech Pipeline<br/>[pipeline.py]"]
  node_audio_preprocessing["Audio Preprocessing<br/>[preprocessing.py]"]
  node_language_detection["Language Detection"]
  node_transcript_formatting["Transcript Formatting"]
  node_whisper["Whisper Transcription<br/>[whisper_service.py]"]
  node_translation["Speech Translation"]
end

node_user(("Analyst"))

node_user -->|"opens"| node_dashboard
node_user -->|"submits text"| node_text_ui
node_user -->|"uploads image"| node_image_ui
node_user -->|"uploads audio"| node_audio_ui
node_user -->|"opens module"| node_video_ui
node_user -->|"reviews analyses"| node_history_ui
node_user -->|"views summaries"| node_insights_ui
node_dashboard -->|"offers access"| node_text_ui
node_dashboard -->|"offers access"| node_image_ui
node_dashboard -->|"offers access"| node_audio_ui
node_dashboard -->|"offers access"| node_video_ui
node_audio_ui -->|"calls"| node_analysis_service
node_analysis_service -.->|"requests analysis"| node_api
node_api -->|"validates payloads"| node_schemas
node_api -->|"screens text"| node_political_gate
node_api -->|"classifies text"| node_text_emotion
node_api -->|"scores image"| node_image_analysis
node_image_analysis -->|"uses settings"| node_image_config
node_api -->|"processes speech"| node_speech_pipeline
node_speech_pipeline -->|"preprocesses audio"| node_audio_preprocessing
node_speech_pipeline -->|"detects language"| node_language_detection
node_speech_pipeline -->|"merges transcripts"| node_transcript_formatting
node_speech_pipeline -->|"transcribes chunks"| node_whisper
node_speech_pipeline -.->|"translates speech"| node_translation
node_translation -->|"translates segments"| node_whisper
node_translation -->|"merges translations"| node_transcript_formatting

click node_dashboard "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/index.tsx"
click node_text_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/text.tsx"
click node_image_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/image.tsx"
click node_audio_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/audio.tsx"
click node_video_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/video.tsx"
click node_history_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/history.tsx"
click node_insights_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/insights.tsx"
click node_settings_ui "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/settings.tsx"
click node_analysis_service "https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/services/analysisService.ts"
click node_api "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/main.py"
click node_schemas "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/schemas.py"
click node_political_gate "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/political_service.py"
click node_text_emotion "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/model_service.py"
click node_image_analysis "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/image_model_service.py"
click node_image_config "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/image_config.py"
click node_speech_pipeline "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/pipeline.py"
click node_audio_preprocessing "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/preprocessing.py"
click node_language_detection "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/language_detection.py"
click node_transcript_formatting "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/transcript_formatter.py"
click node_whisper "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/whisper_service.py"
click node_translation "https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/translation_service.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_dashboard,node_text_ui,node_image_ui,node_audio_ui,node_video_ui,node_history_ui,node_insights_ui,node_settings_ui,node_analysis_service toneBlue
class node_api,node_schemas toneAmber
class node_political_gate,node_text_emotion,node_image_analysis,node_image_config toneMint
class node_speech_pipeline,node_audio_preprocessing,node_language_detection,node_transcript_formatting,node_whisper,node_translation toneRose
class node_user toneIndigo
```

## Components

### User Interface

- [Dashboard](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/index.tsx): `frontend/src/routes/index.tsx`
- [Text Analysis](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/text.tsx): `frontend/src/routes/text.tsx`
- [Image Analysis](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/image.tsx): `frontend/src/routes/image.tsx`
- [Audio Analysis](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/audio.tsx): `frontend/src/routes/audio.tsx`
- [Video Analysis](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/video.tsx): `frontend/src/routes/video.tsx`
- [Analysis History](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/history.tsx): `frontend/src/routes/history.tsx`
- [Insights](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/insights.tsx): `frontend/src/routes/insights.tsx`
- [Settings](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/routes/settings.tsx): `frontend/src/routes/settings.tsx`
- [Analysis Client](https://github.com/ojas-k070/poliemotifusion/blob/main/frontend/src/services/analysisService.ts): `frontend/src/services/analysisService.ts`

### API Orchestration

- [FastAPI Endpoints](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/main.py): `backend/main.py`
- [Request and Result Schemas](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/schemas.py): `backend/schemas.py`

### Text and Image Analysis

- [Text Political Gate](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/political_service.py): `backend/political_service.py`
- [Text Emotion Model](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/model_service.py): `backend/model_service.py`
- [Image Gate and Scoring](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/image_model_service.py): `backend/image_model_service.py`
- [Image Model Configuration](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/image_config.py): `backend/image_config.py`

### Speech Intelligence

- [Speech Pipeline](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/pipeline.py): `backend/speech_intelligence/pipeline.py`
- [Audio Preprocessing](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/preprocessing.py): `backend/speech_intelligence/preprocessing.py`
- [Language Detection](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/language_detection.py): `backend/speech_intelligence/language_detection.py`
- [Transcript Formatting](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/transcript_formatter.py): `backend/speech_intelligence/transcript_formatter.py`
- [Whisper Transcription](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/whisper_service.py): `backend/speech_intelligence/whisper_service.py`
- [Speech Translation](https://github.com/ojas-k070/poliemotifusion/blob/main/backend/speech_intelligence/translation_service.py): `backend/speech_intelligence/translation_service.py`

### Other components

- **Analyst**

## Connections

- Analyst → Dashboard: opens (evidence: `README.md`)
- Analyst → Text Analysis: submits text (evidence: `README.md`)
- Analyst → Image Analysis: uploads image (evidence: `README.md`)
- Analyst → Audio Analysis: uploads audio (evidence: `README.md`)
- Analyst → Video Analysis: opens module (evidence: `README.md`)
- Analyst → Analysis History: reviews analyses (evidence: `README.md`)
- Analyst → Insights: views summaries (evidence: `README.md`)
- Dashboard → Text Analysis: offers access (evidence: `README.md`)
- Dashboard → Image Analysis: offers access (evidence: `README.md`)
- Dashboard → Audio Analysis: offers access (evidence: `README.md`)
- Dashboard → Video Analysis: offers access (evidence: `README.md`)
- Audio Analysis → Analysis Client: calls (evidence: `frontend/src/routes/audio.tsx`)
- Analysis Client → FastAPI Endpoints: requests analysis
- FastAPI Endpoints → Request and Result Schemas: validates payloads (evidence: `backend/main.py`)
- FastAPI Endpoints → Text Political Gate: screens text (evidence: `backend/main.py`)
- FastAPI Endpoints → Text Emotion Model: classifies text (evidence: `backend/main.py`)
- FastAPI Endpoints → Image Gate and Scoring: scores image (evidence: `backend/main.py`)
- Image Gate and Scoring → Image Model Configuration: uses settings (evidence: `backend/image_model_service.py`)
- FastAPI Endpoints → Speech Pipeline: processes speech (evidence: `backend/main.py`)
- Speech Pipeline → Audio Preprocessing: preprocesses audio (evidence: `backend/speech_intelligence/pipeline.py`)
- Speech Pipeline → Language Detection: detects language (evidence: `backend/speech_intelligence/pipeline.py`)
- Speech Pipeline → Transcript Formatting: merges transcripts (evidence: `backend/speech_intelligence/pipeline.py`)
- Speech Pipeline → Whisper Transcription: transcribes chunks (evidence: `backend/speech_intelligence/pipeline.py`)
- Speech Pipeline → Speech Translation: translates speech (evidence: `backend/speech_intelligence/pipeline.py`)
- Speech Translation → Whisper Transcription: translates segments (evidence: `backend/speech_intelligence/translation_service.py`)
- Speech Translation → Transcript Formatting: merges translations (evidence: `backend/speech_intelligence/translation_service.py`)
