# shub1504/ml_project architecture

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

- Interactive diagram: https://gitdiagram.com/shub1504/ml_project
- Repository: https://github.com/shub1504/ml_project

## Overview

MaternalRisk AI is an experimental maternal-health research and education application. A user can enter six physiological measurements in the Streamlit interface for a local SVM classification, or chat with an Azure-hosted assistant that can invoke the same kind of assessment through a registered tool. The interface also presents research findings and dataset information. The excerpts support the prediction, chat, and agent wiring shown here; research assets and other unsampled implementation details are not expanded into unverified connections.

Main entry points: [`app/streamlit_app.py`](https://github.com/shub1504/ml_project/blob/main/app/streamlit_app.py) (Research App), [`agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py) (Agent Host), [`src/predict.py`](https://github.com/shub1504/ml_project/blob/main/src/predict.py) (Prediction Engine), [`agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py`](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py) (Agent Prediction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_streamlit["Research App<br/>[streamlit_app.py]"]
end

subgraph group_inference["Risk Inference"]
  node_local_prediction["Prediction Engine<br/>[predict.py]"]
  node_local_model[("SVM Model")]
  node_agent_prediction["Agent Prediction"]
  node_agent_model[("Agent SVM Model")]
end

subgraph group_assistant["Conversational Assistant"]
  node_agent_client["Agent Client<br/>[agent_client.py]"]
  node_agent_host["Agent Host<br/>[main.py]"]
  node_risk_tool["Assessment Tool<br/>[main.py]"]
end

node_user(("User"))
node_foundry["Azure AI Foundry"]

node_user -->|"uses"| node_streamlit
node_streamlit -->|"requests assessment"| node_local_prediction
node_local_prediction -->|"loads and predicts"| node_local_model
node_streamlit -->|"sends chat"| node_agent_client
node_agent_client -->|"POSTs responses"| node_agent_host
node_agent_host -->|"configures chat"| node_foundry
node_agent_host -->|"registers tool"| node_risk_tool
node_risk_tool -->|"calls prediction"| node_agent_prediction
node_agent_prediction -->|"loads and predicts"| node_agent_model

click node_streamlit "https://github.com/shub1504/ml_project/blob/main/app/streamlit_app.py"
click node_local_prediction "https://github.com/shub1504/ml_project/blob/main/src/predict.py"
click node_local_model "https://github.com/shub1504/ml_project/blob/main/models/maternal_risk_model.joblib"
click node_agent_client "https://github.com/shub1504/ml_project/blob/main/src/agent_client.py"
click node_agent_host "https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py"
click node_risk_tool "https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py"
click node_agent_prediction "https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py"
click node_agent_model "https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/models/maternal_risk_model.joblib"

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_local_prediction,node_local_model,node_agent_prediction,node_agent_model toneAmber
class node_agent_client,node_agent_host,node_risk_tool toneMint
class node_foundry toneIndigo
```

## Components

### User Interface

- [Research App](https://github.com/shub1504/ml_project/blob/main/app/streamlit_app.py): `app/streamlit_app.py`

### Risk Inference

- [Prediction Engine](https://github.com/shub1504/ml_project/blob/main/src/predict.py): `src/predict.py`
- [SVM Model](https://github.com/shub1504/ml_project/blob/main/models/maternal_risk_model.joblib): `models/maternal_risk_model.joblib`
- [Agent Prediction](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py): `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py`
- [Agent SVM Model](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/models/maternal_risk_model.joblib): `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/models/maternal_risk_model.joblib`

### Conversational Assistant

- [Agent Client](https://github.com/shub1504/ml_project/blob/main/src/agent_client.py): `src/agent_client.py`
- [Agent Host](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py): `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`
- [Assessment Tool](https://github.com/shub1504/ml_project/blob/main/agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py): `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`

### Other components

- **User**
- **Azure AI Foundry**

## Connections

- User → Research App: uses (evidence: `app/streamlit_app.py`)
- Research App → Prediction Engine: requests assessment (evidence: `app/streamlit_app.py`)
- Prediction Engine → SVM Model: loads and predicts (evidence: `src/predict.py`)
- Research App → Agent Client: sends chat (evidence: `app/streamlit_app.py`)
- Agent Client → Agent Host: POSTs responses (evidence: `src/agent_client.py`)
- Agent Host → Azure AI Foundry: configures chat (evidence: `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`)
- Agent Host → Assessment Tool: registers tool (evidence: `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`)
- Assessment Tool → Agent Prediction: calls prediction (evidence: `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/main.py`)
- Agent Prediction → Agent SVM Model: loads and predicts (evidence: `agent-framework-agent-with-local-tools-responses/src/agent-framework-agent-with-local-tools-responses/maternal_predict.py`)
