# sivakrishna916/insightai architecture

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

## Overview

InsightAI is a Flask data-analysis app: users upload a CSV or Excel file, receive data-quality metrics, charts, a preview, and AI-generated insights, or request a custom chart and ask questions about the dataset. The graph separates request handling from file processing, quality analysis, column selection, visualization, and AI services. The README documents the user-facing capabilities; template internals were not sampled, so frontend interaction details are not inferred.

Main entry points: [`app.py`](https://github.com/sivakrishna916/insightai/blob/main/app.py) (Flask routes), [`templates/index.html`](https://github.com/sivakrishna916/insightai/blob/main/templates/index.html) (Analysis interface), [`services/chart_service.py`](https://github.com/sivakrishna916/insightai/blob/main/services/chart_service.py) (Automatic charts), [`services/ai_service.py`](https://github.com/sivakrishna916/insightai/blob/main/services/ai_service.py) (Business insights)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_interface["Analysis interface<br/>[index.html]"]
end

subgraph group_requests["Request handling"]
  node_routes["Flask routes<br/>[app.py]"]
end

subgraph group_analysis["Dataset analysis"]
  node_file_reader["File ingestion<br/>[data_service.py]"]
  node_quality["Quality metrics<br/>[data_service.py]"]
  node_column_selection["Column heuristics<br/>[column_utils.py]"]
  node_auto_charts["Automatic charts<br/>[chart_service.py]"]
  node_custom_charts["Custom charts<br/>[chart_service.py]"]
end

subgraph group_ai["AI services"]
  node_insights["Business insights<br/>[ai_service.py]"]
  node_data_chat["Data Q&amp;A<br/>[ai_service.py]"]
end

node_user(("Analyst"))
node_groq["Groq LLM"]

node_user -->|"uses"| node_interface
node_interface -.->|"submits requests"| node_routes
node_routes -->|"renders page"| node_interface
node_routes -->|"reads uploads"| node_file_reader
node_routes -->|"computes metrics"| node_quality
node_routes -->|"generates charts"| node_auto_charts
node_routes -->|"requests insights"| node_insights
node_routes -->|"builds chart"| node_custom_charts
node_routes -->|"asks question"| node_data_chat
node_auto_charts -->|"selects columns"| node_column_selection
node_insights -->|"requests completion"| node_groq
node_data_chat -->|"requests completion"| node_groq

click node_interface "https://github.com/sivakrishna916/insightai/blob/main/templates/index.html"
click node_routes "https://github.com/sivakrishna916/insightai/blob/main/app.py"
click node_file_reader "https://github.com/sivakrishna916/insightai/blob/main/services/data_service.py"
click node_quality "https://github.com/sivakrishna916/insightai/blob/main/services/data_service.py"
click node_column_selection "https://github.com/sivakrishna916/insightai/blob/main/utils/column_utils.py"
click node_auto_charts "https://github.com/sivakrishna916/insightai/blob/main/services/chart_service.py"
click node_custom_charts "https://github.com/sivakrishna916/insightai/blob/main/services/chart_service.py"
click node_insights "https://github.com/sivakrishna916/insightai/blob/main/services/ai_service.py"
click node_data_chat "https://github.com/sivakrishna916/insightai/blob/main/services/ai_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_interface toneBlue
class node_routes toneAmber
class node_file_reader,node_quality,node_column_selection,node_auto_charts,node_custom_charts toneMint
class node_insights,node_data_chat toneRose
class node_user,node_groq toneIndigo
```

## Components

### User experience

- [Analysis interface](https://github.com/sivakrishna916/insightai/blob/main/templates/index.html): `templates/index.html`

### Request handling

- [Flask routes](https://github.com/sivakrishna916/insightai/blob/main/app.py): `app.py`

### Dataset analysis

- [File ingestion](https://github.com/sivakrishna916/insightai/blob/main/services/data_service.py): `services/data_service.py`
- [Quality metrics](https://github.com/sivakrishna916/insightai/blob/main/services/data_service.py): `services/data_service.py`
- [Column heuristics](https://github.com/sivakrishna916/insightai/blob/main/utils/column_utils.py): `utils/column_utils.py`
- [Automatic charts](https://github.com/sivakrishna916/insightai/blob/main/services/chart_service.py): `services/chart_service.py`
- [Custom charts](https://github.com/sivakrishna916/insightai/blob/main/services/chart_service.py): `services/chart_service.py`

### AI services

- [Business insights](https://github.com/sivakrishna916/insightai/blob/main/services/ai_service.py): `services/ai_service.py`
- [Data Q&A](https://github.com/sivakrishna916/insightai/blob/main/services/ai_service.py): `services/ai_service.py`

### Other components

- **Analyst**
- **Groq LLM**

## Connections

- Analyst → Analysis interface: uses (evidence: `README.md`)
- Analysis interface → Flask routes: submits requests
- Flask routes → Analysis interface: renders page (evidence: `app.py`)
- Flask routes → File ingestion: reads uploads (evidence: `app.py`)
- Flask routes → Quality metrics: computes metrics (evidence: `app.py`)
- Flask routes → Automatic charts: generates charts (evidence: `app.py`)
- Flask routes → Business insights: requests insights (evidence: `app.py`)
- Flask routes → Custom charts: builds chart (evidence: `app.py`)
- Flask routes → Data Q&A: asks question (evidence: `app.py`)
- Automatic charts → Column heuristics: selects columns (evidence: `services/chart_service.py`)
- Business insights → Groq LLM: requests completion (evidence: `services/ai_service.py`)
- Data Q&A → Groq LLM: requests completion (evidence: `services/ai_service.py`)
