# divyaprasad-sahu/radi-ai-buddy-medical architecture

> Architecture diagram of the GitHub repository divyaprasad-sahu/radi-ai-buddy-medical, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/divyaprasad-sahu/radi-ai-buddy-medical
- Repository: https://github.com/divyaprasad-sahu/radi-ai-buddy-medical

## Overview

Radi-AI Buddy is a multilingual educational chest-X-ray screening demo: users upload an image, receive a validated-model screening result, and can discuss it with an API-backed assistant or review reports and aggregate research metrics. The React workspace calls a FastAPI service; serving validates checksum-verified ONNX artifacts, while NIH data cleaning and model training are offline research workflows. Edges are limited to relationships shown in excerpts, the source index, or README; unsampled frontend and offline wiring is not inferred.

Main entry points: [`AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx) (Workspace dashboard), [`AOML Deploy/backend/app/main.py`](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/main.py) (FastAPI endpoints), [`AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/api.ts`](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/api.ts) (API client), [`AOML Deploy/backend/app/model.py`](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/model.py) (ONNX validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Screening workspace"]
  node_react_app["React app<br/>[App.tsx]"]
  node_dashboard["Workspace dashboard<br/>[Dashboard.tsx]"]
  node_upload["Image upload"]
  node_result["Screening result<br/>[ResultCard.tsx]"]
  node_assistant_ui["Assistant chat<br/>[Chatbot.tsx]"]
  node_history["Session history<br/>[HistoryPanel.tsx]"]
  node_report["Report preview<br/>[ReportBuilder.tsx]"]
  node_research_ui["Research panel<br/>[ResearchPanel.tsx]"]
  node_translations["Translations<br/>[i18n.ts]"]
  node_frontend_api["API client<br/>[api.ts]"]
end

subgraph group_service["API service"]
  node_api["FastAPI endpoints<br/>[main.py]"]
  node_summary["Localized summaries<br/>[chatbot.py]"]
  node_insights["Research insights<br/>[main.py]"]
end

subgraph group_inference["Model inference"]
  node_inference_logic["Image inference<br/>[predict.py]"]
  node_model_loader["ONNX validation<br/>[model.py]"]
end

subgraph group_research["Offline research"]
  node_cleaning["Dataset cleaning<br/>[clean_nih.py]"]
  node_training["Model training<br/>[train.py]"]
end

subgraph group_integrations["External services"]
  node_groq["Groq assistant"]
  node_nih[("NIH dataset")]
end

node_user(("User"))

node_user -->|"uses"| node_react_app
node_react_app -.->|"routes to"| node_dashboard
node_dashboard -->|"renders"| node_upload
node_dashboard -->|"renders"| node_result
node_dashboard -->|"renders"| node_assistant_ui
node_dashboard -->|"renders"| node_history
node_dashboard -->|"renders"| node_report
node_dashboard -->|"renders"| node_research_ui
node_upload -.->|"submits image"| node_frontend_api
node_assistant_ui -->|"sends chat"| node_frontend_api
node_research_ui -->|"loads insights"| node_frontend_api
node_frontend_api -.->|"calls service"| node_api
node_api -->|"runs inference"| node_inference_logic
node_inference_logic -->|"loads model"| node_model_loader
node_api -->|"checks metadata"| node_model_loader
node_api -->|"formats result"| node_summary
node_api -->|"dispatches chat"| node_groq
node_api -->|"serves insights"| node_insights
node_cleaning -->|"cleans cohort"| node_nih
node_training -.->|"uses cohort"| node_cleaning
node_training -.->|"exports ONNX"| node_model_loader
node_api -->|"reads summaries"| node_insights

click node_react_app "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/App.tsx"
click node_dashboard "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx"
click node_upload "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/UploadComponent.tsx"
click node_result "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResultCard.tsx"
click node_assistant_ui "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Chatbot.tsx"
click node_history "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/HistoryPanel.tsx"
click node_report "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ReportBuilder.tsx"
click node_research_ui "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResearchPanel.tsx"
click node_translations "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/i18n.ts"
click node_frontend_api "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/api.ts"
click node_api "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/main.py"
click node_summary "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/chatbot.py"
click node_inference_logic "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/predict.py"
click node_model_loader "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/model.py"
click node_cleaning "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/clean_nih.py"
click node_training "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/train.py"
click node_insights "https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/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_react_app,node_dashboard,node_upload,node_result,node_assistant_ui,node_history,node_report,node_research_ui,node_translations,node_frontend_api,node_user toneBlue
class node_api,node_summary,node_insights toneAmber
class node_inference_logic,node_model_loader toneMint
class node_cleaning,node_training toneRose
class node_groq,node_nih toneIndigo
```

## Components

### Screening workspace

- [React app](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/App.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/App.tsx`
- [Workspace dashboard](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`
- [Image upload](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/UploadComponent.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/UploadComponent.tsx`
- [Screening result](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResultCard.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResultCard.tsx`
- [Assistant chat](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Chatbot.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Chatbot.tsx`
- [Session history](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/HistoryPanel.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/HistoryPanel.tsx`
- [Report preview](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ReportBuilder.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ReportBuilder.tsx`
- [Research panel](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResearchPanel.tsx): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResearchPanel.tsx`
- [Translations](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/i18n.ts): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/i18n.ts`
- [API client](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/api.ts): `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/lib/api.ts`

### API service

- [FastAPI endpoints](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/main.py): `AOML Deploy/backend/app/main.py`
- [Localized summaries](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/chatbot.py): `AOML Deploy/backend/app/chatbot.py`
- [Research insights](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/main.py): `AOML Deploy/backend/app/main.py`

### Model inference

- [Image inference](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/predict.py): `AOML Deploy/backend/app/predict.py`
- [ONNX validation](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/app/model.py): `AOML Deploy/backend/app/model.py`

### Offline research

- [Dataset cleaning](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/clean_nih.py): `AOML Deploy/backend/clean_nih.py`
- [Model training](https://github.com/divyaprasad-sahu/radi-ai-buddy-medical/blob/main/AOML%20Deploy/backend/train.py): `AOML Deploy/backend/train.py`

### External services

- **Groq assistant**
- **NIH dataset**

### Other components

- **User**

## Connections

- User → React app: uses
- React app → Workspace dashboard: routes to
- Workspace dashboard → Image upload: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Workspace dashboard → Screening result: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Workspace dashboard → Assistant chat: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Workspace dashboard → Session history: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Workspace dashboard → Report preview: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Workspace dashboard → Research panel: renders (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Dashboard.tsx`)
- Image upload → API client: submits image
- Assistant chat → API client: sends chat (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/Chatbot.tsx`)
- Research panel → API client: loads insights (evidence: `AOML Deploy/radi-ai-buddy-main/radi-ai-buddy-main/src/components/ResearchPanel.tsx`)
- API client → FastAPI endpoints: calls service
- FastAPI endpoints → Image inference: runs inference (evidence: `AOML Deploy/backend/app/main.py`)
- Image inference → ONNX validation: loads model (evidence: `AOML Deploy/backend/app/predict.py`)
- FastAPI endpoints → ONNX validation: checks metadata (evidence: `AOML Deploy/backend/app/main.py`)
- FastAPI endpoints → Localized summaries: formats result (evidence: `AOML Deploy/backend/app/main.py`)
- FastAPI endpoints → Groq assistant: dispatches chat (evidence: `AOML Deploy/backend/app/main.py`)
- FastAPI endpoints → Research insights: serves insights (evidence: `AOML Deploy/backend/app/main.py`)
- Dataset cleaning → NIH dataset: cleans cohort (evidence: `README.md`)
- Model training → Dataset cleaning: uses cohort
- Model training → ONNX validation: exports ONNX
- FastAPI endpoints → Research insights: reads summaries (evidence: `AOML Deploy/backend/app/main.py`)
