NeuroOracle / README.md
zxcvb20001's picture
Deploy NeuroOracle KG Explorer with latest graph + rebrand
5c60a92 verified
---
title: NeuroOracle
emoji: 🧠
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Dual-source knowledge graph for NeuroClaw
tags:
- neuroscience
- knowledge-graph
- neuroimaging
- hypothesis-generation
- autoresearch
---
<div align="center">
# NeuroOracle
**A dual-source knowledge graph and hypothesis engine β€” part of [NeuroClaw](https://github.com/CUHK-AIM-Group/NeuroClaw).**
[![NeuroClaw](https://img.shields.io/badge/Part%20of-NeuroClaw-blueviolet)](https://github.com/CUHK-AIM-Group/NeuroClaw)
[![Project Page](https://img.shields.io/badge/Project-Homepage-orange)](https://cuhk-aim-group.github.io/NeuroClaw/)
[![Paper](https://img.shields.io/badge/arXiv-2604.24696-b31b1b)](https://arxiv.org/abs/2604.24696)
[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/CUHK-AIM-Group/NeuroClaw/blob/main/LICENSE)
</div>
---
## What is NeuroOracle?
NeuroOracle is the knowledge-graph component of **NeuroClaw**, an autonomous research framework for neuroimaging. It combines two complementary information sources to provide a quality-grounded foundation for hypothesis generation:
1. **Curated structured databases** β€” concepts and relations imported from NeuroNames, MeSH, DisGeNET, BrainMap, and Cognitive Atlas, all aligned to UMLS semantic types.
2. **PubMed-derived scientific claims** β€” evidence-weighted edges extracted from neuroimaging literature using LLM-based claim extractors, with provenance (PMID, p-value, sample size, study type) preserved on every edge.
Together they form a graph of approximately **89K concept nodes** and **174K edges**, covering brain anatomy, diseases, genes, neurotransmitters, drugs, cognitive functions, imaging features, connectivity, visual stimuli, and emotion/vigilance labels.
This Space provides an interactive explorer for browsing the graph, inspecting evidence chains behind individual claims, and visualising multi-hop hypothesis paths.
## Why dual-source matters
Existing autoresearch systems either rely on free-form LLM ideation (no quality anchor) or on a single curated KG (limited coverage and stale evidence). NeuroOracle's dual-source design is what enables NeuroClaw to:
- Generate hypotheses with **traceable evidence chains** back to specific PubMed papers
- Filter or re-rank hypotheses using **evidence weights** (effect size, sample size, replicability)
- Iterate the graph itself in response to new findings, rather than treating the KG as a static asset
## NeuroClaw ecosystem
NeuroOracle is one of three modules within the broader NeuroClaw system:
| Module | Role |
|--------|------|
| **NeuroClaw** | Top-level system: data processing, model execution, skill library (81 skills across 29 datasets) |
| **NeuroOracle** | Knowledge graph and hypothesis engine (this Space) |
| **NeuroBench** | Multi-agent neuroimaging workflow benchmark |
NeuroClaw is the umbrella framework; NeuroOracle is its scientific memory; NeuroBench measures how effectively the agent can use that memory to do real research work.
## What you can do here
- **Browse concepts** across 13 domain tags (neuroanatomy, disease, gene, drug, imaging_feature, connectivity, cognitive_function, visual_stimulus, emotion, vigilance, paradigm, dataset, ml_model)
- **Inspect claims** β€” every PubMed-derived edge carries the source paper, predicate (`is_biomarker_of`, `predicts`, `correlates_with`, etc.), and structured evidence fields
- **Trace hypothesis paths** β€” multi-hop reasoning examples such as `visual stimulus β†’ functional ROI β†’ anatomical region`, or `imaging feature β†’ gene β†’ disease`
- **Filter subgraphs** by domain, dataset, or relation type for focused exploration
## Links
- 🏠 **Project homepage**: <https://cuhk-aim-group.github.io/NeuroClaw/>
- πŸ’» **Source code (GitHub)**: <https://github.com/CUHK-AIM-Group/NeuroClaw>
- πŸ“„ **Technical report (arXiv)**: <https://arxiv.org/abs/2604.24696>
- 🧠 **NeuroOracle docs page**: <https://cuhk-aim-group.github.io/NeuroClaw/neuro-oracle.html>
## Citation
If NeuroOracle or NeuroClaw is useful for your research, please cite the NeuroClaw technical report:
```bibtex
@article{neuroclaw2026,
title = {NeuroClaw: Closed-Loop Agentic AI for Executable and Reproducible Neuroimaging Research},
author = {NeuroClaw Team},
journal = {arXiv preprint arXiv:2604.24696},
year = {2026},
url = {https://arxiv.org/abs/2604.24696}
}
```
## License
MIT β€” same as the NeuroClaw repository. See <https://github.com/CUHK-AIM-Group/NeuroClaw/blob/main/LICENSE> for full terms.
## Contact
For questions or issues, please open an issue on the [NeuroClaw GitHub repository](https://github.com/CUHK-AIM-Group/NeuroClaw/issues).