# haricharan8/meetintel-ai architecture

> Architecture diagram of the GitHub repository haricharan8/meetintel-ai, 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/haricharan8/meetintel-ai
- Repository: https://github.com/haricharan8/meetintel-ai

## Overview

MeetIntel AI turns authenticated meeting recordings into searchable, actionable knowledge. The main workflow is upload and validation, audio preparation, transcription and diarization, structured AI analysis, relational persistence, vector indexing, then semantic search or grounded Q&A and export. The Streamlit application is the primary user interface; FastAPI exposes integration, search, and question-answering endpoints. The graph preserves documented capabilities, but several subsystem links rely on README descriptions because their implementation excerpts were not provided.

Main entry points: [`ui/meeting.py`](https://github.com/haricharan8/meetintel-ai/blob/main/ui/meeting.py) (Meeting Views), [`ai/meeting_analyzer.py`](https://github.com/haricharan8/meetintel-ai/blob/main/ai/meeting_analyzer.py) (Meeting Analysis), [`storage/knowledge.py`](https://github.com/haricharan8/meetintel-ai/blob/main/storage/knowledge.py) (Knowledge Index), [`app.py`](https://github.com/haricharan8/meetintel-ai/blob/main/app.py) (Streamlit App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_streamlit["Streamlit App<br/>[app.py]"]
  node_auth_ui["Login UI<br/>[auth.py]"]
  node_upload_ui["Meeting Upload<br/>[upload.py]"]
  node_meeting_ui["Meeting Views<br/>[meeting.py]"]
  node_search_ui["Knowledge Search"]
  node_settings_ui["AI Settings<br/>[settings.py]"]
  node_reports["Report Export"]
end

subgraph group_processing["Meeting Processing"]
  node_validation["File Validation<br/>[validator.py]"]
  node_audio["Audio Preparation<br/>[processor.py]"]
  node_transcription["Transcription<br/>[whisper_engine.py]"]
  node_diarization["Speaker Diarization<br/>[diarization.py]"]
  node_formatter["Transcript Formatting<br/>[formatter.py]"]
end

subgraph group_intelligence["AI and Retrieval"]
  node_analyzer["Meeting Analysis"]
  node_provider_manager["Provider Failover"]
  node_gemini["Gemini Provider<br/>[gemini.py]"]
  node_openai["OpenAI Provider<br/>[openai_provider.py]"]
  node_rag["RAG Service<br/>[rag.py]"]
  node_knowledge["Knowledge Index<br/>[knowledge.py]"]
end

subgraph group_persistence["Storage and API"]
  node_relational[("Meeting Database<br/>[models.py]")]
  node_vector_store[("Vector Store<br/>[vector_store.py]")]
  node_api["FastAPI<br/>[main.py]"]
end

node_user(("Meeting User"))
node_speech_service{{"Local Speech Models"}}
node_embedding_service{{"Embedding Model"}}

node_user -->|"uses"| node_streamlit
node_streamlit -->|"routes to"| node_auth_ui
node_streamlit -->|"routes to"| node_upload_ui
node_streamlit -->|"routes to"| node_meeting_ui
node_streamlit -->|"routes to"| node_search_ui
node_streamlit -->|"routes to"| node_settings_ui
node_upload_ui -->|"validates files"| node_validation
node_upload_ui -->|"starts processing"| node_meeting_ui
node_meeting_ui -->|"prepares audio"| node_audio
node_audio -->|"provides audio"| node_transcription
node_audio -->|"provides audio"| node_diarization
node_meeting_ui -->|"invokes"| node_transcription
node_meeting_ui -->|"invokes"| node_diarization
node_meeting_ui -->|"uses"| node_formatter
node_formatter -->|"provides transcript"| node_analyzer
node_meeting_ui -->|"analyzes transcript"| node_analyzer
node_transcription -.->|"uses"| node_speech_service
node_diarization -.->|"uses"| node_speech_service
node_analyzer -->|"requests insights"| node_provider_manager
node_provider_manager -->|"dispatches"| node_gemini
node_provider_manager -->|"falls back"| node_openai
node_gemini -.->|"returns insights"| node_analyzer
node_openai -.->|"returns insights"| node_analyzer
node_meeting_ui -->|"stores meeting"| node_relational
node_meeting_ui -->|"indexes meeting"| node_knowledge
node_knowledge -->|"reads meeting data"| node_relational
node_knowledge -->|"embeds chunks"| node_embedding_service
node_knowledge -->|"writes chunks"| node_vector_store
node_search_ui -->|"searches"| node_knowledge
node_search_ui -->|"asks questions"| node_analyzer
node_analyzer -->|"delegates RAG"| node_rag
node_rag -->|"retrieves context"| node_knowledge
node_rag -.->|"generates answer"| node_provider_manager
node_api -->|"searches"| node_knowledge
node_api -->|"asks questions"| node_analyzer
node_api -->|"reads meetings"| node_relational
node_meeting_ui -->|"exports reports"| node_reports

click node_streamlit "https://github.com/haricharan8/meetintel-ai/blob/main/app.py"
click node_auth_ui "https://github.com/haricharan8/meetintel-ai/blob/main/ui/auth.py"
click node_upload_ui "https://github.com/haricharan8/meetintel-ai/blob/main/ui/upload.py"
click node_meeting_ui "https://github.com/haricharan8/meetintel-ai/blob/main/ui/meeting.py"
click node_search_ui "https://github.com/haricharan8/meetintel-ai/blob/main/ui/knowledge_search.py"
click node_settings_ui "https://github.com/haricharan8/meetintel-ai/blob/main/ui/settings.py"
click node_reports "https://github.com/haricharan8/meetintel-ai/tree/main/reports"
click node_validation "https://github.com/haricharan8/meetintel-ai/blob/main/audio/validator.py"
click node_audio "https://github.com/haricharan8/meetintel-ai/blob/main/audio/processor.py"
click node_transcription "https://github.com/haricharan8/meetintel-ai/blob/main/transcription/whisper_engine.py"
click node_diarization "https://github.com/haricharan8/meetintel-ai/blob/main/transcription/diarization.py"
click node_formatter "https://github.com/haricharan8/meetintel-ai/blob/main/transcription/formatter.py"
click node_analyzer "https://github.com/haricharan8/meetintel-ai/blob/main/ai/meeting_analyzer.py"
click node_provider_manager "https://github.com/haricharan8/meetintel-ai/blob/main/ai/provider_manager.py"
click node_gemini "https://github.com/haricharan8/meetintel-ai/blob/main/ai/gemini.py"
click node_openai "https://github.com/haricharan8/meetintel-ai/blob/main/ai/openai_provider.py"
click node_rag "https://github.com/haricharan8/meetintel-ai/blob/main/ai/rag.py"
click node_knowledge "https://github.com/haricharan8/meetintel-ai/blob/main/storage/knowledge.py"
click node_relational "https://github.com/haricharan8/meetintel-ai/blob/main/storage/models.py"
click node_vector_store "https://github.com/haricharan8/meetintel-ai/blob/main/storage/vector_store.py"
click node_api "https://github.com/haricharan8/meetintel-ai/blob/main/api/main.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_streamlit,node_auth_ui,node_upload_ui,node_meeting_ui,node_search_ui,node_settings_ui,node_reports,node_user toneBlue
class node_validation,node_audio,node_transcription,node_diarization,node_formatter toneAmber
class node_analyzer,node_provider_manager,node_gemini,node_openai,node_rag,node_knowledge toneMint
class node_relational,node_vector_store,node_api toneRose
class node_speech_service,node_embedding_service toneIndigo
```

## Components

### User Experience

- [Streamlit App](https://github.com/haricharan8/meetintel-ai/blob/main/app.py): `app.py`
- [Login UI](https://github.com/haricharan8/meetintel-ai/blob/main/ui/auth.py): `ui/auth.py`
- [Meeting Upload](https://github.com/haricharan8/meetintel-ai/blob/main/ui/upload.py): `ui/upload.py`
- [Meeting Views](https://github.com/haricharan8/meetintel-ai/blob/main/ui/meeting.py): `ui/meeting.py`
- [Knowledge Search](https://github.com/haricharan8/meetintel-ai/blob/main/ui/knowledge_search.py): `ui/knowledge_search.py`
- [AI Settings](https://github.com/haricharan8/meetintel-ai/blob/main/ui/settings.py): `ui/settings.py`
- [Report Export](https://github.com/haricharan8/meetintel-ai/tree/main/reports): `reports`

### Meeting Processing

- [File Validation](https://github.com/haricharan8/meetintel-ai/blob/main/audio/validator.py): `audio/validator.py`
- [Audio Preparation](https://github.com/haricharan8/meetintel-ai/blob/main/audio/processor.py): `audio/processor.py`
- [Transcription](https://github.com/haricharan8/meetintel-ai/blob/main/transcription/whisper_engine.py): `transcription/whisper_engine.py`
- [Speaker Diarization](https://github.com/haricharan8/meetintel-ai/blob/main/transcription/diarization.py): `transcription/diarization.py`
- [Transcript Formatting](https://github.com/haricharan8/meetintel-ai/blob/main/transcription/formatter.py): `transcription/formatter.py`

### AI and Retrieval

- [Meeting Analysis](https://github.com/haricharan8/meetintel-ai/blob/main/ai/meeting_analyzer.py): `ai/meeting_analyzer.py`
- [Provider Failover](https://github.com/haricharan8/meetintel-ai/blob/main/ai/provider_manager.py): `ai/provider_manager.py`
- [Gemini Provider](https://github.com/haricharan8/meetintel-ai/blob/main/ai/gemini.py): `ai/gemini.py`
- [OpenAI Provider](https://github.com/haricharan8/meetintel-ai/blob/main/ai/openai_provider.py): `ai/openai_provider.py`
- [RAG Service](https://github.com/haricharan8/meetintel-ai/blob/main/ai/rag.py): `ai/rag.py`
- [Knowledge Index](https://github.com/haricharan8/meetintel-ai/blob/main/storage/knowledge.py): `storage/knowledge.py`

### Storage and API

- [Meeting Database](https://github.com/haricharan8/meetintel-ai/blob/main/storage/models.py): `storage/models.py`
- [Vector Store](https://github.com/haricharan8/meetintel-ai/blob/main/storage/vector_store.py): `storage/vector_store.py`
- [FastAPI](https://github.com/haricharan8/meetintel-ai/blob/main/api/main.py): `api/main.py`

### Other components

- **Meeting User**
- **Local Speech Models**
- **Embedding Model**

## Connections

- Meeting User → Streamlit App: uses
- Streamlit App → Login UI: routes to (evidence: `app.py`)
- Streamlit App → Meeting Upload: routes to (evidence: `app.py`)
- Streamlit App → Meeting Views: routes to (evidence: `app.py`)
- Streamlit App → Knowledge Search: routes to (evidence: `app.py`)
- Streamlit App → AI Settings: routes to (evidence: `app.py`)
- Meeting Upload → File Validation: validates files (evidence: `ui/upload.py`)
- Meeting Upload → Meeting Views: starts processing (evidence: `ui/meeting.py`)
- Meeting Views → Audio Preparation: prepares audio (evidence: `ui/meeting.py`)
- Audio Preparation → Transcription: provides audio
- Audio Preparation → Speaker Diarization: provides audio
- Meeting Views → Transcription: invokes (evidence: `ui/meeting.py`)
- Meeting Views → Speaker Diarization: invokes (evidence: `ui/meeting.py`)
- Meeting Views → Transcript Formatting: uses (evidence: `ui/meeting.py`)
- Transcript Formatting → Meeting Analysis: provides transcript
- Meeting Views → Meeting Analysis: analyzes transcript (evidence: `ui/meeting.py`)
- Transcription → Local Speech Models: uses
- Speaker Diarization → Local Speech Models: uses
- Meeting Analysis → Provider Failover: requests insights (evidence: `ai/meeting_analyzer.py`)
- Provider Failover → Gemini Provider: dispatches (evidence: `ai/provider_manager.py`)
- Provider Failover → OpenAI Provider: falls back (evidence: `ai/provider_manager.py`)
- Gemini Provider → Meeting Analysis: returns insights
- OpenAI Provider → Meeting Analysis: returns insights
- Meeting Views → Meeting Database: stores meeting (evidence: `ui/meeting.py`)
- Meeting Views → Knowledge Index: indexes meeting (evidence: `ui/meeting.py`)
- Knowledge Index → Meeting Database: reads meeting data (evidence: `storage/knowledge.py`)
- Knowledge Index → Embedding Model: embeds chunks (evidence: `storage/knowledge.py`)
- Knowledge Index → Vector Store: writes chunks (evidence: `storage/knowledge.py`)
- Knowledge Search → Knowledge Index: searches (evidence: `ui/knowledge_search.py`)
- Knowledge Search → Meeting Analysis: asks questions (evidence: `ui/knowledge_search.py`)
- Meeting Analysis → RAG Service: delegates RAG (evidence: `ai/meeting_analyzer.py`)
- RAG Service → Knowledge Index: retrieves context (evidence: `ai/rag.py`)
- RAG Service → Provider Failover: generates answer
- FastAPI → Knowledge Index: searches (evidence: `api/main.py`)
- FastAPI → Meeting Analysis: asks questions (evidence: `api/main.py`)
- FastAPI → Meeting Database: reads meetings (evidence: `api/main.py`)
- Meeting Views → Report Export: exports reports
