# kartikeya1911/adslm-adaptive_datascience_language_model architecture

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

- Interactive diagram: https://gitdiagram.com/kartikeya1911/adslm-adaptive_datascience_language_model
- Repository: https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model

## Overview

ADSLM is an AutoML and data-science copilot for uploaded tabular data. Users submit a dataset through the Streamlit UI; the FastAPI backend profiles it, detects a task, preprocesses data, benchmarks models, and returns explanations, governance checks, scale estimates, and reports. The README documents the hybrid Streamlit-to-FastAPI deployment and report downloads. The route-to-service relationships are supported by the route imports and documented pipeline; training-to-evaluation is supported by the training source index. Some service internals and frontend calls were not excerpted, so those links rely on README documentation.

Main entry points: [`app/api/routes.py`](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/api/routes.py) (API Routes), [`frontend/app.py`](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/frontend/app.py) (Streamlit UI), [`app/services/training.py`](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/training.py) (Model Training), [`reports`](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/tree/main/reports) (Report Files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_streamlit["Streamlit UI<br/>[app.py]"]
end

subgraph group_api["API Layer"]
  node_fastapi["FastAPI App<br/>[main.py]"]
  node_routes["API Routes<br/>[routes.py]"]
  node_config["Runtime Config<br/>[config.py]"]
end

subgraph group_analysis["Data &amp; ML Pipeline"]
  node_profile["Dataset Profiling"]
  node_task["Task Detection<br/>[task_detection.py]"]
  node_preprocess["Leakage-Safe Prep<br/>[preprocessing.py]"]
  node_recommend["Model Recommendation"]
  node_training["Model Training<br/>[training.py]"]
  node_evaluation["Model Evaluation<br/>[evaluation.py]"]
end

subgraph group_outputs["Insights &amp; Governance"]
  node_xai["Explainability<br/>[explainability.py]"]
  node_insights["Narrative Insights"]
  node_expertise["Expertise Adaptation"]
  node_compliance["Governance Audit"]
  node_bigdata["Scale Profiling<br/>[bigdata_engine.py]"]
  node_reports["Report Generation"]
  node_model_store[("Saved Models")]
  node_report_store[("Report Files")]
end

node_user(("Dataset User"))

node_user -->|"uploads data"| node_streamlit
node_streamlit -->|"sends requests"| node_fastapi
node_fastapi -->|"registers routes"| node_routes
node_routes -->|"profiles data"| node_profile
node_routes -->|"detects task"| node_task
node_routes -->|"preprocesses data"| node_preprocess
node_routes -->|"selects candidates"| node_recommend
node_routes -->|"trains models"| node_training
node_training -->|"evaluates models"| node_evaluation
node_routes -->|"explains model"| node_xai
node_routes -->|"generates insights"| node_insights
node_routes -->|"adapts insights"| node_expertise
node_routes -->|"audits compliance"| node_compliance
node_routes -->|"profiles scale"| node_bigdata
node_routes -->|"builds reports"| node_reports
node_training -->|"saves model"| node_model_store
node_reports -->|"writes reports"| node_report_store
node_streamlit -->|"retrieves reports"| node_report_store
node_config -->|"configures storage"| node_model_store
node_config -->|"configures storage"| node_report_store

click node_streamlit "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/frontend/app.py"
click node_fastapi "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/main.py"
click node_routes "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/api/routes.py"
click node_config "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/core/config.py"
click node_profile "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/dataset_analyzer.py"
click node_task "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/task_detection.py"
click node_preprocess "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/preprocessing.py"
click node_recommend "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/model_recommendation.py"
click node_training "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/training.py"
click node_evaluation "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/evaluation.py"
click node_xai "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/explainability.py"
click node_insights "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/insight_generator.py"
click node_expertise "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/expertise_adaptation.py"
click node_compliance "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/regulatory_compliance.py"
click node_bigdata "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/bigdata_engine.py"
click node_reports "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/report_generator.py"
click node_model_store "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/tree/main/saved_models"
click node_report_store "https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/tree/main/reports"

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_user toneBlue
class node_fastapi,node_routes,node_config toneAmber
class node_profile,node_task,node_preprocess,node_recommend,node_training,node_evaluation toneMint
class node_xai,node_insights,node_expertise,node_compliance,node_bigdata,node_reports,node_model_store,node_report_store toneRose
```

## Components

### User Interface

- [Streamlit UI](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/frontend/app.py): `frontend/app.py`

### API Layer

- [FastAPI App](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/main.py): `main.py`
- [API Routes](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/api/routes.py): `app/api/routes.py`
- [Runtime Config](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/core/config.py): `app/core/config.py`

### Data & ML Pipeline

- [Dataset Profiling](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/dataset_analyzer.py): `app/services/dataset_analyzer.py`
- [Task Detection](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/task_detection.py): `app/services/task_detection.py`
- [Leakage-Safe Prep](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/preprocessing.py): `app/services/preprocessing.py`
- [Model Recommendation](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/model_recommendation.py): `app/services/model_recommendation.py`
- [Model Training](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/training.py): `app/services/training.py`
- [Model Evaluation](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/evaluation.py): `app/services/evaluation.py`

### Insights & Governance

- [Explainability](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/explainability.py): `app/services/explainability.py`
- [Narrative Insights](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/insight_generator.py): `app/services/insight_generator.py`
- [Expertise Adaptation](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/expertise_adaptation.py): `app/services/expertise_adaptation.py`
- [Governance Audit](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/regulatory_compliance.py): `app/services/regulatory_compliance.py`
- [Scale Profiling](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/bigdata_engine.py): `app/services/bigdata_engine.py`
- [Report Generation](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/blob/main/app/services/report_generator.py): `app/services/report_generator.py`
- [Saved Models](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/tree/main/saved_models): `saved_models`
- [Report Files](https://github.com/kartikeya1911/adslm-adaptive_datascience_language_model/tree/main/reports): `reports`

### Other components

- **Dataset User**

## Connections

- Dataset User → Streamlit UI: uploads data (evidence: `README.md`)
- Streamlit UI → FastAPI App: sends requests (evidence: `README.md`)
- FastAPI App → API Routes: registers routes (evidence: `main.py`)
- API Routes → Dataset Profiling: profiles data (evidence: `app/api/routes.py`)
- API Routes → Task Detection: detects task (evidence: `README.md`)
- API Routes → Leakage-Safe Prep: preprocesses data (evidence: `README.md`)
- API Routes → Model Recommendation: selects candidates (evidence: `README.md`)
- API Routes → Model Training: trains models (evidence: `README.md`)
- Model Training → Model Evaluation: evaluates models (evidence: `app/services/training.py`)
- API Routes → Explainability: explains model (evidence: `app/api/routes.py`)
- API Routes → Narrative Insights: generates insights (evidence: `README.md`)
- API Routes → Expertise Adaptation: adapts insights (evidence: `README.md`)
- API Routes → Governance Audit: audits compliance (evidence: `app/api/routes.py`)
- API Routes → Scale Profiling: profiles scale (evidence: `app/api/routes.py`)
- API Routes → Report Generation: builds reports (evidence: `app/api/routes.py`)
- Model Training → Saved Models: saves model (evidence: `app/services/training.py`)
- Report Generation → Report Files: writes reports (evidence: `app/services/report_generator.py`)
- Streamlit UI → Report Files: retrieves reports (evidence: `README.md`)
- Runtime Config → Saved Models: configures storage (evidence: `app/core/config.py`)
- Runtime Config → Report Files: configures storage (evidence: `app/core/config.py`)
