# thedeepakreddy/datasciencestudio-askdeepakai architecture

> Architecture diagram of the GitHub repository thedeepakreddy/datasciencestudio-askdeepakai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thedeepakreddy/datasciencestudio-askdeepakai
- Repository: https://github.com/thedeepakreddy/datasciencestudio-askdeepakai

## Overview

AskDeepakAI is a browser-based data science studio. A user imports a dataset, cleans and explores it, runs statistical analysis and modeling, builds dashboards, and produces reports. Its agent team can plan and carry out tasks through the interface, with approvals, checks, reviews, recovery, and undo. The README documents these product capabilities; source-index references support several internal links. Unsampled modules are represented by their listed paths, without inferring their specific call relationships.

Main entry points: [`src/App.tsx`](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/App.tsx) (Studio Shell), [`src/swarm/useSwarm.ts`](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/useSwarm.ts) (Swarm Hook), [`src/utils/api.ts`](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/api.ts) (API Client), [`src/components/MLPipeline.tsx`](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/MLPipeline.tsx) (Modeling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Data Workflow"]
  node_import["Data Import<br/>[DataUploader.tsx]"]
  node_clean["Data Cleaning<br/>[DataCleaning.tsx]"]
  node_operations["Data Operations<br/>[registry.ts]"]
  node_explore["Data Exploration<br/>[EDAReport.tsx]"]
  node_eda["EDA Engine<br/>[edaEngine.ts]"]
  node_statistics["Statistical Analysis"]
  node_model["Modeling<br/>[MLPipeline.tsx]"]
  node_dashboard["Dashboards"]
  node_reports["Reports<br/>[ReportsHub.tsx]"]
end

subgraph group_agents["Agent Team"]
  node_swarmui["Ask AI Chat"]
  node_swarmhook["Swarm Hook<br/>[useSwarm.ts]"]
  node_planner["Task Planning<br/>[plan.ts]"]
  node_capabilities["Agent Capabilities<br/>[catalog.ts]"]
  node_runtime["Task Runtime<br/>[runtime.ts]"]
  node_review["Run Review"]
end

subgraph group_platform["Studio Platform"]
  node_app["Studio Shell<br/>[App.tsx]"]
  node_workspace[("Workspace Storage<br/>[workspaceStore.ts]")]
  node_api["API Client<br/>[api.ts]"]
end

subgraph group_services["Compute Services"]
  node_mlengine["ML Engine<br/>[mlEngine.ts]"]
  node_node["Node API Server<br/>[server.ts]"]
  node_python["ML Service<br/>[main.py]"]
end

node_user(("Studio User"))
node_gemini{{"Gemini"}}

node_user -->|"uses"| node_app
node_app -->|"opens"| node_import
node_app -->|"routes to"| node_clean
node_app -->|"routes to"| node_explore
node_app -->|"routes to"| node_statistics
node_app -->|"routes to"| node_model
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_reports
node_import -->|"profiles data"| node_explore
node_clean -->|"applies operations"| node_operations
node_explore -->|"computes summaries"| node_eda
node_model -->|"trains models"| node_mlengine
node_app -->|"saves sessions"| node_workspace
node_user -->|"asks"| node_swarmui
node_swarmui -->|"starts runs"| node_swarmhook
node_swarmhook -->|"requests plans"| node_planner
node_swarmhook -->|"runs tasks"| node_runtime
node_runtime -->|"dispatches tasks"| node_capabilities
node_runtime -->|"requests review"| node_review
node_swarmhook -->|"persists runs"| node_workspace
node_model -->|"requests compute"| node_api
node_api -->|"calls API"| node_node
node_node -->|"uses ML service"| node_python
node_swarmhook -->|"requests AI"| node_api
node_api -->|"sends prompts"| node_gemini

click node_app "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/App.tsx"
click node_import "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/DataUploader.tsx"
click node_clean "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/DataCleaning.tsx"
click node_operations "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/operations/registry.ts"
click node_explore "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/EDAReport.tsx"
click node_eda "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/edaEngine.ts"
click node_statistics "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/StatisticsStage.tsx"
click node_model "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/MLPipeline.tsx"
click node_mlengine "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/mlEngine.ts"
click node_dashboard "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/StakeholderDashboard.tsx"
click node_reports "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/ReportsHub.tsx"
click node_swarmui "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/AssistiveTouchBot.tsx"
click node_swarmhook "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/useSwarm.ts"
click node_planner "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/plan.ts"
click node_capabilities "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/catalog.ts"
click node_runtime "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/runtime.ts"
click node_review "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/orchestratorReview.ts"
click node_workspace "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/workspaceStore.ts"
click node_api "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/api.ts"
click node_node "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/server.ts"
click node_python "https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/mlops_service/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_import,node_clean,node_operations,node_explore,node_eda,node_statistics,node_model,node_dashboard,node_reports,node_user toneBlue
class node_swarmui,node_swarmhook,node_planner,node_capabilities,node_runtime,node_review toneAmber
class node_app,node_workspace,node_api toneMint
class node_mlengine,node_node,node_python toneRose
class node_gemini toneIndigo
```

## Components

### Data Workflow

- [Data Import](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/DataUploader.tsx): `src/components/DataUploader.tsx`
- [Data Cleaning](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/DataCleaning.tsx): `src/components/DataCleaning.tsx`
- [Data Operations](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/operations/registry.ts): `src/operations/registry.ts`
- [Data Exploration](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/EDAReport.tsx): `src/components/EDAReport.tsx`
- [EDA Engine](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/edaEngine.ts): `src/utils/edaEngine.ts`
- [Statistical Analysis](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/StatisticsStage.tsx): `src/components/StatisticsStage.tsx`
- [Modeling](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/MLPipeline.tsx): `src/components/MLPipeline.tsx`
- [Dashboards](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/StakeholderDashboard.tsx): `src/components/StakeholderDashboard.tsx`
- [Reports](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/ReportsHub.tsx): `src/components/ReportsHub.tsx`

### Agent Team

- [Ask AI Chat](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/components/AssistiveTouchBot.tsx): `src/components/AssistiveTouchBot.tsx`
- [Swarm Hook](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/useSwarm.ts): `src/swarm/useSwarm.ts`
- [Task Planning](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/plan.ts): `src/swarm/plan.ts`
- [Agent Capabilities](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/catalog.ts): `src/swarm/catalog.ts`
- [Task Runtime](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/runtime.ts): `src/swarm/runtime.ts`
- [Run Review](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/swarm/orchestratorReview.ts): `src/swarm/orchestratorReview.ts`

### Studio Platform

- [Studio Shell](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/App.tsx): `src/App.tsx`
- [Workspace Storage](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/workspaceStore.ts): `src/utils/workspaceStore.ts`
- [API Client](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/api.ts): `src/utils/api.ts`

### Compute Services

- [ML Engine](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/src/utils/mlEngine.ts): `src/utils/mlEngine.ts`
- [Node API Server](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/server.ts): `server.ts`
- [ML Service](https://github.com/thedeepakreddy/datasciencestudio-askdeepakai/blob/main/mlops_service/main.py): `mlops_service/main.py`

### Other components

- **Studio User**
- **Gemini**

## Connections

- Studio User → Studio Shell: uses (evidence: `README.md`)
- Studio Shell → Data Import: opens (evidence: `src/App.tsx`)
- Studio Shell → Data Cleaning: routes to (evidence: `src/App.tsx`)
- Studio Shell → Data Exploration: routes to (evidence: `src/App.tsx`)
- Studio Shell → Statistical Analysis: routes to (evidence: `README.md`)
- Studio Shell → Modeling: routes to (evidence: `src/App.tsx`)
- Studio Shell → Dashboards: routes to (evidence: `src/App.tsx`)
- Studio Shell → Reports: routes to (evidence: `src/App.tsx`)
- Data Import → Data Exploration: profiles data (evidence: `README.md`)
- Data Cleaning → Data Operations: applies operations (evidence: `README.md`)
- Data Exploration → EDA Engine: computes summaries (evidence: `README.md`)
- Modeling → ML Engine: trains models (evidence: `src/components/MLPipeline.tsx`)
- Studio Shell → Workspace Storage: saves sessions (evidence: `src/App.tsx`)
- Studio User → Ask AI Chat: asks (evidence: `README.md`)
- Ask AI Chat → Swarm Hook: starts runs (evidence: `README.md`)
- Swarm Hook → Task Planning: requests plans (evidence: `src/swarm/useSwarm.ts`)
- Swarm Hook → Task Runtime: runs tasks (evidence: `src/swarm/useSwarm.ts`)
- Task Runtime → Agent Capabilities: dispatches tasks (evidence: `src/swarm/runtime.ts`)
- Task Runtime → Run Review: requests review (evidence: `src/swarm/orchestratorReview.ts`)
- Swarm Hook → Workspace Storage: persists runs (evidence: `src/swarm/useSwarm.ts`)
- Modeling → API Client: requests compute (evidence: `README.md`)
- API Client → Node API Server: calls API (evidence: `README.md`)
- Node API Server → ML Service: uses ML service (evidence: `README.md`)
- Swarm Hook → API Client: requests AI (evidence: `src/swarm/useSwarm.ts`)
- API Client → Gemini: sends prompts (evidence: `README.md`)
