Python MIT

HyperGraphRAG

[NeurIPS 2025] Official resources of "HyperGraphRAG: Retrieval-Augmented Generation via Hypergraph-Structured Knowledge Representation".

L

LHRLAB

Dernière activité 12 mai 2026
LHRLAB/HyperGraphRAG

453

étoiles

74

forks

9

issues ouvertes

graphraghypergraphknowledge-graphlarge-language-models

Ce README est souvent en anglais.

HyperGraphRAG

Official resources of "HyperGraphRAG: Retrieval-Augmented Generation via Hypergraph-Structured Knowledge Representation". Haoran Luo, Haihong E, Guanting Chen, Yandan Zheng, Xiaobao Wu, Yikai Guo, Qika Lin, Yu Feng, Zemin Kuang, Meina Song, Yifan Zhu, Luu Anh Tuan. NeurIPS 2025 [paper].

Overview

Environment Setup

conda create -n hypergraphrag python=3.11
conda activate hypergraphrag
pip install -r requirements.txt

Quick Start

Knowledge HyperGraph Construction

import os
import json
from hypergraphrag import HyperGraphRAG
os.environ["OPENAI_API_KEY"] = "your_openai_api_key"

rag = HyperGraphRAG(working_dir=f"expr/example")

with open(f"example_contexts.json", mode="r") as f:
    unique_contexts = json.load(f)
    
rag.insert(unique_contexts)

Knowledge HyperGraph Query

import os
from hypergraphrag import HyperGraphRAG
os.environ["OPENAI_API_KEY"] = "your_openai_api_key"

rag = HyperGraphRAG(working_dir=f"expr/example")

query_text = 'How strong is the evidence supporting a systolic BP target of 120–129 mmHg in elderly or frail patients, considering potential risks like orthostatic hypotension, the balance between cardiovascular benefits and adverse effects, and the feasibility of implementation in diverse healthcare settings?'

result = rag.query(query_text)
print(result)

For evaluation, please refer to the evaluation folder.

BibTex

If you find this work is helpful for your research, please cite:

@inproceedings{luo2025hypergraphrag,
 author = {Luo, Haoran and E, Haihong and Chen, Guanting and Zheng, Yandan and Wu, Xiaobao and Guo, Yikai and Lin, Qika and Feng, Yu and Kuang, Zemin and Song, Meina and Zhu, Yifan and Luu, Anh Tuan},
 booktitle = {Advances in Neural Information Processing Systems},
 editor = {D. Belgrave and C. Zhang and H. Lin and R. Pascanu and P. Koniusz and M. Ghassemi and N. Chen},
 pages = {152206--152234},
 publisher = {Curran Associates, Inc.},
 title = {HyperGraphRAG: Retrieval-Augmented Generation via Hypergraph-Structured Knowledge Representation},
 url = {https://proceedings.neurips.cc/paper_files/paper/2025/file/df55ee6e59f8ac4a625219e11fe9ddba-Paper-Conference.pdf},
 volume = {38},
 year = {2025}
}

For further questions, please contact: haoran.luo@ieee.org.

Acknowledgement

This repo benefits from LightRAG, Text2NKG, and HAHE. Thanks for their wonderful works.

Projets similaires

[EMNLP2025] LightRAG: Simple and Fast Retrieval-Augmented Generation

Pythondoclinggenaigpt
HHKUDS
39,9 k étoiles5,6 k

A modular graph-based Retrieval-Augmented Generation (RAG) system

Pythongptgpt-4gpt4
Mmicrosoft
36,2 k étoiles3,8 k

Awesome-GraphRAG: A curated list of resources (surveys, papers, benchmarks, and opensource projects) on graph-based retrieval-augmented generation.

graphraggraphrag-papergraphrag-survey
DDEEP-PolyU
2,7 k étoiles238