HemingZhang commited on
Commit
10ce31a
Β·
verified Β·
1 Parent(s): 2a5bb3b

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +31 -46
README.md CHANGED
@@ -1,36 +1,35 @@
1
  # GALAX: Graph-Augmented Language Model for Explainable Reinforcement-Guided Subgraph Reasoning in Precision Medicine
2
 
3
  <div align="center">
4
- <img src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/logo.svg?raw=true" width="60%" alt="DeepSeek-V3" />
5
  </div>
6
- <hr>
7
  <div align="center" style="line-height: 1;">
8
- <a href="https://www.deepseek.com/" target="_blank" style="margin: 2px;">
9
- <img alt="Homepage" src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/badge.svg?raw=true" style="display: inline-block; vertical-align: middle;"/>
 
10
  </a>
11
- <a href="https://chat.deepseek.com/" target="_blank" style="margin: 2px;">
12
- <img alt="Chat" src="https://img.shields.io/badge/πŸ€–%20Chat-DeepSeek%20V3-536af5?color=536af5&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
 
 
13
  </a>
14
- <a href="https://huggingface.co/deepseek-ai" target="_blank" style="margin: 2px;">
15
- <img alt="Hugging Face" src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-DeepSeek%20AI-ffc107?color=ffc107&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
 
 
16
  </a>
17
  </div>
18
 
19
  <div align="center" style="line-height: 1;">
20
- <a href="https://discord.gg/Tc7c45Zzu5" target="_blank" style="margin: 2px;">
21
- <img alt="Discord" src="https://img.shields.io/badge/Discord-DeepSeek%20AI-7289da?logo=discord&logoColor=white&color=7289da" style="display: inline-block; vertical-align: middle;"/>
22
- </a>
23
- <a href="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/qr.jpeg?raw=true" target="_blank" style="margin: 2px;">
24
- <img alt="Wechat" src="https://img.shields.io/badge/WeChat-DeepSeek%20AI-brightgreen?logo=wechat&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
25
  </a>
26
- <a href="https://twitter.com/deepseek_ai" target="_blank" style="margin: 2px;">
27
- <img alt="Twitter Follow" src="https://img.shields.io/badge/Twitter-deepseek_ai-white?logo=x&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
28
- </a>
29
- </div>
30
 
31
- <div align="center" style="line-height: 1;">
32
  <a href="LICENSE" style="margin: 2px;">
33
- <img alt="License" src="https://img.shields.io/badge/License-MIT-f5de53?&color=f5de53" style="display: inline-block; vertical-align: middle;"/>
34
  </a>
35
  </div>
36
 
@@ -41,7 +40,7 @@
41
  ![GALAX Overall Architecture](./Figure3.png)
42
 
43
  **GALAX** is a graph-augmented language model that integrates:
44
- - **LLaMA3-8B-Instruct** as the language backbone (QA-tuned).
45
  - **Graph Attention Network (GAT)** trained on BioMedGraphica (multi-omics + knowledge graph).
46
  - **Reinforcement-guided subgraph generator** for interpretable target prioritization.
47
 
@@ -65,16 +64,11 @@ lm_model = AutoModelForCausalLM.from_pretrained(
65
  torch_dtype="auto"
66
  )
67
 
68
- # 2. Access graph foundation + best combined model
69
  repo_path = snapshot_download(model_id)
70
-
71
- graph_path = os.path.join(repo_path, "graph_foundation")
72
- print("Graph foundation files:", os.listdir(graph_path))
73
-
74
  combined_model_path = os.path.join(repo_path, "best_combined_model.pt")
75
- if os.path.exists(combined_model_path):
76
- best_combined_model = torch.load(combined_model_path, map_location="cpu")
77
- print("Loaded best_combined_model.pt successfully")
78
  ```
79
 
80
  ---
@@ -90,17 +84,6 @@ if os.path.exists(combined_model_path):
90
 
91
  ---
92
 
93
- ## πŸ“‰ Baselines & Ablations
94
-
95
- - **M2T (Multiomic2Target):** Only omics β†’ poor performance.
96
- - **L3+Omics:** No QA finetuning β†’ weak results.
97
- - **L3-FT(QA)+Omics:** Large gain from QA finetuning.
98
- - **GAT / G-Retriever+pre-GAT:** Partial improvements, unstable.
99
- - **+ Static KG:** Minimal or negative gains.
100
- - **GALAX (QA + KG + RL):** Consistent cross-dataset gains (2–5% absolute).
101
-
102
- ---
103
-
104
 
105
  ## πŸ“Š Results
106
 
@@ -146,8 +129,8 @@ GALAX consistently outperforms baselines and ablation variants.
146
  ## πŸ”¬ Intended Uses
147
 
148
  - **Research use only**
149
- - Target prioritization in **cancer biology**
150
- - Benchmarking **graph-language foundation models** in target priorization
151
 
152
  ---
153
 
@@ -157,8 +140,10 @@ If you use this model, please cite:
157
 
158
  ```bibtex
159
  @article{zhang2025galax,
160
- title={GALAX: Graph-Augmented Language Model for Explainable Reinforcement-Guided Subgraph Reasoning in Precision Medicine},
161
- author={Zhang, Heming and Li, Fuhai and Chen, Yixin and others},
162
- year={2025},
163
- journal={Preprint}
164
- }
 
 
 
1
  # GALAX: Graph-Augmented Language Model for Explainable Reinforcement-Guided Subgraph Reasoning in Precision Medicine
2
 
3
  <div align="center">
4
+ <img src="./GALAX-logo.png" width="40%" alt="GALAX" />
5
  </div>
6
+
7
  <div align="center" style="line-height: 1;">
8
+ <!-- GitHub -->
9
+ <a href="https://github.com/FuhaiLiAiLab/GALAX" target="_blank" style="margin: 2px;">
10
+ <img alt="GitHub" src="https://img.shields.io/badge/GitHub-GALAX%20Code-181717?logo=github&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
11
  </a>
12
+
13
+ <!-- Hugging Face Model -->
14
+ <a href="https://huggingface.co/FuhaiLiAiLab/GALAX" target="_blank" style="margin: 2px;">
15
+ <img alt="Hugging Face Model" src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-GALAX%20Model-ffc107?color=ffc107&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
16
  </a>
17
+
18
+ <!-- Hugging Face Dataset -->
19
+ <a href="https://huggingface.co/datasets/FuhaiLiAiLab/Target-QA" target="_blank" style="margin: 2px;">
20
+ <img alt="Hugging Face Dataset" src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Target--QA%20Dataset-ff6f61?color=ffc107&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
21
  </a>
22
  </div>
23
 
24
  <div align="center" style="line-height: 1;">
25
+ <!-- arXiv -->
26
+ <a href="https://arxiv.org/abs/2509.20935" target="_blank" style="margin: 2px;">
27
+ <img alt="arXiv" src="https://img.shields.io/badge/arXiv-2509.20935-b31b1b?logo=arxiv&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
 
 
28
  </a>
 
 
 
 
29
 
30
+ <!-- License -->
31
  <a href="LICENSE" style="margin: 2px;">
32
+ <img alt="License" src="https://img.shields.io/badge/License-MIT-0a4d92?logo=open-source-initiative&logoColor=white" style="display: inline-block; vertical-align: middle;"/>
33
  </a>
34
  </div>
35
 
 
40
  ![GALAX Overall Architecture](./Figure3.png)
41
 
42
  **GALAX** is a graph-augmented language model that integrates:
43
+ - **LLaMA3-8B-Instruct** as the language backbone (Target-QA tuned).
44
  - **Graph Attention Network (GAT)** trained on BioMedGraphica (multi-omics + knowledge graph).
45
  - **Reinforcement-guided subgraph generator** for interpretable target prioritization.
46
 
 
64
  torch_dtype="auto"
65
  )
66
 
67
+ # 2. Access graph foundation model
68
  repo_path = snapshot_download(model_id)
 
 
 
 
69
  combined_model_path = os.path.join(repo_path, "best_combined_model.pt")
70
+ device = "cuda" if torch.cuda.is_available() else "cpu"
71
+ best_combined_model = torch.load(combined_model_path, map_location=device)
 
72
  ```
73
 
74
  ---
 
84
 
85
  ---
86
 
 
 
 
 
 
 
 
 
 
 
 
87
 
88
  ## πŸ“Š Results
89
 
 
129
  ## πŸ”¬ Intended Uses
130
 
131
  - **Research use only**
132
+ - Benchmarking **graph-language foundation models** in target priorization
133
+ - Target prioritization in **cancer biology**
134
 
135
  ---
136
 
 
140
 
141
  ```bibtex
142
  @article{zhang2025galax,
143
+ title = {GALAX: Graph-Augmented Language Model for Explainable Reinforcement-Guided Subgraph Reasoning in Precision Medicine},
144
+ author = {Zhang, Heming and Huang, Di and Li, Wenyu and Province, Michael and Chen, Yixin and Payne, Philip and Li, Fuhai},
145
+ journal = {arXiv preprint arXiv:2509.20935},
146
+ year = {2025},
147
+ doi = {10.48550/arXiv.2509.20935},
148
+ url = {https://arxiv.org/abs/2509.20935}
149
+ }