← all repositories
AQ-MedAI/MedResearcher-R1

Medical reasoning agents built from synthetic knowledge trajectories

MedResearcher-R1 is a training-data factory that converts structured domain knowledge into multi-turn reasoning trajectories for specialized deep-research agents.

MedResearcher-R1
Not currently ranked — collecting fresh signals.
star history

What it does

MedResearcher-R1 is an end-to-end framework for manufacturing training data for domain-specific reasoning models. It starts by building a knowledge graph and generating complex question-answer pairs with automated reasoning paths, then synthesizes multi-turn agent trajectories that include tool use, filters them for quality, and rewrites them into polished training examples. A final evaluation pipeline benchmarks the resulting model. The medical domain is the headline use case, but the architecture is framed as a general recipe for any deep-research specialty.

The interesting bit

Rather than scraping existing text, the system algorithmically extracts subgraphs from a curated knowledge graph to create questions, answers, and step-by-step “cheat sheets” that guide trajectory generation. A Masked Trajectory Guidance system then rewrites raw agent rollouts into cleaner training examples. It is essentially a synthetic curriculum designer where the structure of the domain knowledge directly shapes the reasoning patterns the model learns.

Key highlights

  • End-to-end pipeline spanning KnowledgeGraphConstruction, TrajectoryGenerationPipeline, and EvaluationPipeline
  • Five subgraph sampling strategies—mixed, augmented_chain, community_core_path, dual_core_bridge, and max_chain—for multi-hop question generation
  • Automated quality filtering and LLM-powered trajectory rewriting with Masked Trajectory Guidance
  • Ships with an open-source medical QA dataset and a D3.js web frontend for graph visualization
  • Benchmarked on MedBrowseComp, GAIA, and XBench-DeepSearch

Caveats

  • The built-in read tool hard-codes an OpenRouter dependency; using another provider requires editing tools/tool_visit.py
  • Operating the full pipeline means managing separate configs and environment variables across three distinct component directories

Verdict

Worth exploring if you need a systematic way to generate synthetic reasoning trajectories from structured knowledge for fine-tuning domain agents. Skip it if you are looking for a drop-in medical chatbot—this is a data-production workshop, not a finished product.

Frequently asked

What is AQ-MedAI/MedResearcher-R1?
MedResearcher-R1 is a training-data factory that converts structured domain knowledge into multi-turn reasoning trajectories for specialized deep-research agents.
Is MedResearcher-R1 open source?
Yes — AQ-MedAI/MedResearcher-R1 is open source, released under the Apache-2.0 license.
What language is MedResearcher-R1 written in?
AQ-MedAI/MedResearcher-R1 is primarily written in Python.
How popular is MedResearcher-R1?
AQ-MedAI/MedResearcher-R1 has 515 stars on GitHub.
Where can I find MedResearcher-R1?
AQ-MedAI/MedResearcher-R1 is on GitHub at https://github.com/AQ-MedAI/MedResearcher-R1.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.