xushuwen23 commited on
Commit
63330cc
Β·
verified Β·
1 Parent(s): de4cf3a

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +3 -18
README.md CHANGED
@@ -14,31 +14,16 @@ tags:
14
 
15
  [**πŸ“„ Paper (arXiv:2603.28533)**](https://arxiv.org/abs/2603.28533) | [**πŸ’» GitHub**](https://github.com/XuShuwenn/GraphWalker) | [**πŸ€— Model**](https://huggingface.co/xushuwen23/GraphWalker-7B)
16
 
17
- **GraphWalker-7B** is a specialized large language model fine-tuned from [Qwen2.5-7B-Instruct](https://huggingface.co/Qwen/Qwen2.5-7B-Instruct) for **Agentic Knowledge Graph Question Answering (KGQA)**. GraphWalker treats multi-hop KGQA as a sequential graph-walking process, learning to navigate knowledge graphs via synthetic trajectory curriculum β€” achieving strong generalization with a single, compact 7B model.
18
 
19
  ---
20
 
21
  ## 🌟 Overview
22
 
23
- Multi-hop KGQA requires reasoning over complex, interconnected entities across a knowledge graph. Existing approaches either rely on rigid retrieval pipelines or expensive multi-module LLM orchestration. **GraphWalker** addresses this with two core ideas:
24
-
25
- 1. **Agentic Graph Walking:** The model acts as an agent that iteratively traverses a KG, selecting which edges to follow at each step based on the question and accumulated context β€” effectively decomposing multi-hop questions into a series of local, grounded decisions.
26
-
27
- 2. **Synthetic Trajectory Curriculum (STC):** Instead of relying on expensive human-annotated reasoning chains, GraphWalker is trained on *synthetically generated* graph-walking trajectories. The curriculum is structured to progressively increase trajectory complexity, enabling the model to internalize robust multi-hop strategies.
28
-
29
- Together, these designs allow GraphWalker-7B to outperform much larger models and complex multi-agent systems on standard KGQA benchmarks, while remaining efficient at inference time.
30
 
31
  ---
32
 
33
- ## πŸ”‘ Key Features
34
-
35
- - **Agentic KG Navigation:** Frames KGQA as an iterative, step-by-step graph traversal rather than a single-shot retrieval-and-generate task.
36
- - **Synthetic Trajectory Curriculum:** Trains on automatically constructed walking trajectories with progressively increasing difficulty, eliminating the need for costly human annotation.
37
- - **Lazy Greedy Search with Frontier Expansion:** An efficient beam-search-style graph traversal algorithm that maximizes information gain while keeping context size tractable.
38
- - **Single-Model Efficiency:** Achieves competitive performance with a single 7B model, without multi-agent overhead.
39
- - **Broad KG Compatibility:** Designed to generalize across standard KGQA benchmarks (e.g., WebQSP, CWQ, GrailQA).
40
-
41
- ---
42
 
43
  ## πŸ› οΈ Usage
44
 
@@ -67,7 +52,7 @@ vllm serve "./GraphWalker-7B" \
67
  --dtype auto \
68
  --chat-template "./GraphWalker-7B/chat_template.jinja"
69
  ```
70
-
71
 
72
 
73
  ---
 
14
 
15
  [**πŸ“„ Paper (arXiv:2603.28533)**](https://arxiv.org/abs/2603.28533) | [**πŸ’» GitHub**](https://github.com/XuShuwenn/GraphWalker) | [**πŸ€— Model**](https://huggingface.co/xushuwen23/GraphWalker-7B)
16
 
17
+ **GraphWalker-7B** is a specialized large language model fine-tuned from [Qwen2.5-7B-Instruct](https://huggingface.co/Qwen/Qwen2.5-7B-Instruct) for **Agentic Knowledge Graph Question Answering (KGQA)**. GraphWalker learns to navigate knowledge graphs via synthetic trajectory curriculum β€” achieving strong generalization with a single, compact 7B model.
18
 
19
  ---
20
 
21
  ## 🌟 Overview
22
 
23
+ **GraphWalker** is an agentic framework for multi-turn Knowledge Graph Question Answering (KGQA) over **Global Knowledge Graphs** (e.g., Freebase). It transforms LLMs into reasoning agents that autonomously navigate massive KGs through a "Think-Query-Observe" loop, optimized via a synthetic curriculum.
 
 
 
 
 
 
24
 
25
  ---
26
 
 
 
 
 
 
 
 
 
 
27
 
28
  ## πŸ› οΈ Usage
29
 
 
52
  --dtype auto \
53
  --chat-template "./GraphWalker-7B/chat_template.jinja"
54
  ```
55
+ For training and evaluation, see [**πŸ’» GitHub**](https://github.com/XuShuwenn/GraphWalker) for details.
56
 
57
 
58
  ---