Hugging Face's logo

Spaces:
MedSwin
/
README
Running

App Files Community
BinKhoaLe1812 commited on
Commit
9ad7816
·
verified ·
1 Parent(s): c963bd1

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +43 -60
README.md CHANGED
@@ -1,8 +1,8 @@
1
  ---
2
  title: README
3
- emoji: 🩺
4
- colorFrom: green
5
- colorTo: gray
6
  sdk: static
7
  pinned: false
8
  ---
@@ -15,23 +15,6 @@ _Swinburne University of Technology_ | _Unit: COS30018 Intelligent Systems_
15
 
16
  ---
17
 
18
- ## Table of Contents
19
- - [Overview](#overview)
20
- - [Core Capabilities](#core-capabilities)
21
- - [Architecture](#architecture)
22
- - [Data, Training & Reproducibility](#data-training--reproducibility)
23
- - [Evaluation](#evaluation)
24
- - [Safety, Ethics & Compliance](#safety-ethics--compliance)
25
- - [Tech Stack](#tech-stack)
26
- - [Repository Structure](#repository-structure)
27
- - [Roadmap](#roadmap)
28
- - [Team](#team)
29
- - [Academic Context](#academic-context)
30
- - [Disclaimer](#disclaimer)
31
- - [Citation](#citation)
32
- - [License](#license)
33
-
34
- ---
35
 
36
  ## Overview
37
  This project builds a **multi-agent system** for clinical decision support. A central **reasoning orchestrator** (MCP) routes user problems to **domain-specialist agents**—Diagnostics, Pharmacology, and Triage—then fuses their outputs with evidence from an **Agentic RAG** pipeline over EMR/EHR data and **PubMed** literature. The system prioritizes **accuracy, traceability, and safety** with strict evaluation and retrieval safety rails.
@@ -90,56 +73,56 @@ This project builds a **multi-agent system** for clinical decision support. A ce
90
  | | |
91
  +---------------------------+ evidence queries +-------------------+-----------+----+----------+
92
  | 5. VectorDB / Long-Term | <--------------------------- | 4. Agentic RAG (Query Router --> Retriever --> |
93
- | Memory (EMR+Lit embeds, | ---------------------------> | Safety Rails) |
94
- | chat turns, provenance) | store traces/embeddings +-------------------+-------------------------+-+
95
- +---------------------------+ | |
96
- | top-k, citations |
97
- v v
98
- +-------------+ +---------------+
99
- | 4c. Med KB | | 4d. EMR |
100
- | PubMed, | | summarizer |
101
- | guidelines | | (PHI-safe) |
102
- +-------------+ +---------------+
103
-
104
  |
 
105
  | answers + rationale + citations
106
  v
107
  +-------------------------+------------------------+
108
- | 7. Evidence Fusion & Self-Consistency (MCP) |
109
- | voting, SLM adjudication, risk flags, refusal |
110
  +-------------------------+------------------------+
111
  |
112
  v
113
- +------------------------+ final report (summary, plan, citations, cautions) +--------------------+
114
- | 1. Clinician UI / EMR | <----------------------------------------------------------------- | 8. Evaluation & |
115
- | (display result) | | QA Harness |
116
- +------------------------+ --------------------- telemetry / traces -------------------------> | MedMCQA, |
117
- | PubMedQA, sim |
118
- | audits, LR ctrl |
119
- +-----------------+
120
  ```
121
 
122
  ### *L2. Agentic RAG Internals*
123
 
124
  ```plaintext
125
  +----------------------------- 4. Agentic RAG ----------------------------------------------+
126
- | Inputs: symptoms, vitals, meds, files, chat LTM snippets |
127
- | |
128
- | +-----------------+ +-----------------+ +--------------------+ |
129
  | | 4b Query Router | --> | 4b Rewriter | --> | 4b/RET Retriever | -- top-k --> |
130
- | | (Node / Graph) | | (expand/disamb) | | (vector + keyword) | |
131
- | +--------+--------+ +-----------------+ +----------+---------+ |
132
  | | filter τ | |
133
- | +--------v--------+ +------v------+ +-----------+ |
134
- | | 4 SR Safety | allowlist, section filters, | 4c Med KB | | 4d EMR | |
135
- | | Rails | dedupe, provenance enforcement | (PubMed/GL) | | Summarizer| |
136
  | +--------+--------+ +------+------ + +-----+-----+ |
137
- | | | | |
138
- | +--------v--------+ +------v------+ +-----v-----+ |
139
- | | 5 VectorDB/LTM | <---- write embeddings/traces ----| evidence | | patient | |
140
- | | (embeds+proven.)| | bundle | | snippets | |
141
- | +-----------------+ +-------------+ +-----------+ |
142
- +------------------------------------------------------------------------------------------+
143
  Outputs: Evidence bundle [{snippet, section, citation, similarity}], EMR summary, provenance map
144
  ```
145
 
@@ -150,13 +133,13 @@ Clinician --> UI/EMR --> MCP Orchestrator --> RAG (Router --> Retriever --> Safe
150
  ^ | \
151
  | v \
152
  | EMR Summarizer ----------------------------\
153
- | \
154
  \------------------------------ Final Report <----- Evidence Fusion <---- Agents (Dx/Rx/Triage)
155
- | ^ /
156
- | | /
157
- +--> VectorDB/LTM -----+----- write ----
158
- \
159
- --> Evaluation/QA
160
  ```
161
 
162
  ---
 
1
  ---
2
  title: README
3
+ emoji: 🌍
4
+ colorFrom: blue
5
+ colorTo: indigo
6
  sdk: static
7
  pinned: false
8
  ---
 
15
 
16
  ---
17
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
18
 
19
  ## Overview
20
  This project builds a **multi-agent system** for clinical decision support. A central **reasoning orchestrator** (MCP) routes user problems to **domain-specialist agents**—Diagnostics, Pharmacology, and Triage—then fuses their outputs with evidence from an **Agentic RAG** pipeline over EMR/EHR data and **PubMed** literature. The system prioritizes **accuracy, traceability, and safety** with strict evaluation and retrieval safety rails.
 
73
  | | |
74
  +---------------------------+ evidence queries +-------------------+-----------+----+----------+
75
  | 5. VectorDB / Long-Term | <--------------------------- | 4. Agentic RAG (Query Router --> Retriever --> |
76
+ | Memory (EMR+Lit embeds, | ---------------------------> | Safety Rails) |
77
+ | chat turns, provenance) | store traces/embeddings +-------------------+----------------------------+
78
+ +---------------------------+ | |
79
+ | top-k, citations |
80
+ v v
81
+ +-------------+ +---------------+
82
+ | 4c. Med KB | | 4d. EMR |
83
+ | PubMed, | | summarizer |
84
+ | guidelines | | (PHI-safe) |
85
+ +-------------+ +---------------+
 
86
  |
87
+ | |
88
  | answers + rationale + citations
89
  v
90
  +-------------------------+------------------------+
91
+ | 7. Evidence Fusion & Self-Consistency (MCP) |
92
+ | voting, SLM adjudication, risk flags, refusal |
93
  +-------------------------+------------------------+
94
  |
95
  v
96
+ +------------------------+ final report (summary, plan, citations, cautions) +-----------------+
97
+ | 1. Clinician UI / EMR | <------------------------------------------------------------- | 8. Evaluation & |
98
+ | (display result) | | QA Harness |
99
+ +------------------------+ --------------------- telemetry / traces --------------------> | MedMCQA, |
100
+ | PubMedQA, sim |
101
+ | audits, LR ctrl |
102
+ +-----------------+
103
  ```
104
 
105
  ### *L2. Agentic RAG Internals*
106
 
107
  ```plaintext
108
  +----------------------------- 4. Agentic RAG ----------------------------------------------+
109
+ | Inputs: symptoms, vitals, meds, files, chat LTM snippets |
110
+ | |
111
+ | +-----------------+ +-----------------+ +--------------------+ |
112
  | | 4b Query Router | --> | 4b Rewriter | --> | 4b/RET Retriever | -- top-k --> |
113
+ | | (Node / Graph) | | (expand/disamb) | | (vector + keyword) | |
114
+ | +--------+--------+ +-----------------+ +----------+---------+ |
115
  | | filter τ | |
116
+ | +--------v--------+ +------v------+ +-----------+ |
117
+ | | 4 SR Safety | allowlist, section filters, | 4c Med KB | | 4d EMR | |
118
+ | | Rails | dedupe, provenance enforcement | (PubMed/GL) | | Summarizer| |
119
  | +--------+--------+ +------+------ + +-----+-----+ |
120
+ | | | | |
121
+ | +--------v--------+ +------v------+ +-----v-----+ |
122
+ | | 5 VectorDB/LTM | <---- write embeddings/traces ----| evidence | | patient | |
123
+ | | (embeds+proven.)| | bundle | | snippets | |
124
+ | +-----------------+ +-------------+ +-----------+ |
125
+ +-------------------------------------------------------------------------------------------+
126
  Outputs: Evidence bundle [{snippet, section, citation, similarity}], EMR summary, provenance map
127
  ```
128
 
 
133
  ^ | \
134
  | v \
135
  | EMR Summarizer ----------------------------\
136
+ | \
137
  \------------------------------ Final Report <----- Evidence Fusion <---- Agents (Dx/Rx/Triage)
138
+ | ^ /
139
+ | | /
140
+ +--> VectorDB/LTM -----+--- write ----
141
+ \
142
+ --> Evaluation/QA
143
  ```
144
 
145
  ---