# carcajo/mtbank-ai-call-analytics architecture

> Architecture diagram of the GitHub repository carcajo/mtbank-ai-call-analytics, 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/carcajo/mtbank-ai-call-analytics
- Repository: https://github.com/carcajo/mtbank-ai-call-analytics

## Overview

This is an AI call-analytics platform for contact centers. The principal workflow accepts an audio recording through either the REST API or OpenWebUI pipeline, transcribes it, optionally diarizes speakers, and returns structured analysis. The analysis graph sequences classification, quality scoring, compliance checks, and summarization. The README also documents live pipeline status and Markdown reporting. The graph follows shown calls and documented capabilities; source details for some OpenWebUI behavior and runtime integrations were not sampled.

Main entry points: [`agents/graph.py`](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/graph.py) (Analysis Graph), [`api/main.py`](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/api/main.py) (REST API), [`agents/__init__.py`](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/__init__.py) (LLM Client Setup), [`utils/logger.py`](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/utils/logger.py) (JSON Agent Logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingestion["API Ingestion"]
  node_api["REST API<br/>[main.py]"]
end

subgraph group_speech["Speech Processing"]
  node_transcription["Whisper Transcription<br/>[transcriber.py]"]
  node_diarization["Speaker Diarization<br/>[transcriber.py]"]
end

subgraph group_analysis["Call Analysis"]
  node_llm_config["LLM Client Setup<br/>[__init__.py]"]
  node_graph["Analysis Graph<br/>[graph.py]"]
  node_classifier["Topic and Priority<br/>[classifier.py]"]
  node_quality["Quality Checklist<br/>[quality.py]"]
  node_compliance["Compliance Check<br/>[compliance.py]"]
  node_summarizer["Summary and Actions<br/>[summarizer.py]"]
  node_logger["JSON Agent Logging<br/>[logger.py]"]
end

subgraph group_chat["Chat Integration"]
  node_pipeline["OpenWebUI Pipeline<br/>[pipeline.py]"]
end

node_caller(("Caller"))
node_openrouter{{"OpenRouter LLM"}}

node_caller -->|"uploads audio"| node_api
node_caller -->|"submits audio or URL"| node_pipeline
node_pipeline -->|"posts audio"| node_api
node_api -->|"transcribes audio"| node_transcription
node_transcription -->|"assigns speakers"| node_diarization
node_api -->|"analyzes transcript"| node_graph
node_graph -->|"dispatches first"| node_classifier
node_graph -->|"dispatches next"| node_quality
node_graph -->|"dispatches next"| node_compliance
node_graph -->|"dispatches last"| node_summarizer
node_classifier -->|"gets LLM client"| node_llm_config
node_quality -->|"gets LLM client"| node_llm_config
node_compliance -->|"gets LLM client"| node_llm_config
node_summarizer -->|"gets LLM client"| node_llm_config
node_llm_config -->|"configures endpoint"| node_openrouter
node_classifier -->|"logs agent I/O"| node_logger
node_quality -->|"logs agent I/O"| node_logger
node_compliance -->|"logs agent I/O"| node_logger
node_summarizer -->|"logs agent I/O"| node_logger
node_api -->|"returns JSON"| node_caller
node_pipeline -->|"streams report"| node_caller

click node_api "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/api/main.py"
click node_pipeline "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/pipelines/pipeline.py"
click node_transcription "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/asr/transcriber.py"
click node_diarization "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/asr/transcriber.py"
click node_llm_config "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/__init__.py"
click node_graph "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/graph.py"
click node_classifier "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/classifier.py"
click node_quality "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/quality.py"
click node_compliance "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/compliance.py"
click node_summarizer "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/summarizer.py"
click node_logger "https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/utils/logger.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_api toneBlue
class node_transcription,node_diarization toneAmber
class node_llm_config,node_graph,node_classifier,node_quality,node_compliance,node_summarizer,node_logger,node_openrouter toneMint
class node_pipeline toneRose
class node_caller toneIndigo
```

## Components

### API Ingestion

- [REST API](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/api/main.py): `api/main.py`

### Speech Processing

- [Whisper Transcription](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/asr/transcriber.py): `asr/transcriber.py`
- [Speaker Diarization](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/asr/transcriber.py): `asr/transcriber.py`

### Call Analysis

- [LLM Client Setup](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/__init__.py): `agents/__init__.py`
- [Analysis Graph](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/graph.py): `agents/graph.py`
- [Topic and Priority](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/classifier.py): `agents/classifier.py`
- [Quality Checklist](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/quality.py): `agents/quality.py`
- [Compliance Check](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/compliance.py): `agents/compliance.py`
- [Summary and Actions](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/agents/summarizer.py): `agents/summarizer.py`
- [JSON Agent Logging](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/utils/logger.py): `utils/logger.py`

### Chat Integration

- [OpenWebUI Pipeline](https://github.com/carcajo/mtbank-ai-call-analytics/blob/main/pipelines/pipeline.py): `pipelines/pipeline.py`

### Other components

- **Caller**
- **OpenRouter LLM**

## Connections

- Caller → REST API: uploads audio (evidence: `README.md`)
- Caller → OpenWebUI Pipeline: submits audio or URL (evidence: `README.md`)
- OpenWebUI Pipeline → REST API: posts audio (evidence: `pipelines/pipeline.py`)
- REST API → Whisper Transcription: transcribes audio (evidence: `api/main.py`)
- Whisper Transcription → Speaker Diarization: assigns speakers (evidence: `asr/transcriber.py`)
- REST API → Analysis Graph: analyzes transcript (evidence: `api/main.py`)
- Analysis Graph → Topic and Priority: dispatches first (evidence: `agents/graph.py`)
- Analysis Graph → Quality Checklist: dispatches next (evidence: `agents/graph.py`)
- Analysis Graph → Compliance Check: dispatches next (evidence: `agents/graph.py`)
- Analysis Graph → Summary and Actions: dispatches last (evidence: `agents/graph.py`)
- Topic and Priority → LLM Client Setup: gets LLM client (evidence: `agents/classifier.py`)
- Quality Checklist → LLM Client Setup: gets LLM client (evidence: `agents/quality.py`)
- Compliance Check → LLM Client Setup: gets LLM client (evidence: `agents/compliance.py`)
- Summary and Actions → LLM Client Setup: gets LLM client (evidence: `agents/summarizer.py`)
- LLM Client Setup → OpenRouter LLM: configures endpoint (evidence: `agents/__init__.py`)
- Topic and Priority → JSON Agent Logging: logs agent I/O (evidence: `agents/classifier.py`)
- Quality Checklist → JSON Agent Logging: logs agent I/O (evidence: `agents/quality.py`)
- Compliance Check → JSON Agent Logging: logs agent I/O (evidence: `agents/compliance.py`)
- Summary and Actions → JSON Agent Logging: logs agent I/O (evidence: `agents/summarizer.py`)
- REST API → Caller: returns JSON (evidence: `api/main.py`)
- OpenWebUI Pipeline → Caller: streams report (evidence: `pipelines/pipeline.py`)
