Skip to content

Heta Framework v0.1.2 — Unified Graph RAG Procedures

Latest
Latest

Choose a tag to compare

View all tags
@tulongshaonian771 tulongshaonian771 released this 05 Aug 10:09
· 5 commits to main since this release
v0.1.2
aff2656

Heta Framework v0.1.2 — Unified Graph RAG Procedures

Release notes:

Heta Framework v0.1.2 introduces a unified graph extraction architecture and built-in support for multiple Graph RAG
approaches.

Highlights

Unified Graph Extraction

Graph construction now starts from a shared universal graph representation. GraphRAG, LightRAG, HiRAG, LeanRAG, and Heta
Graph can reuse the same extraction results and adapt them to their own graph structures.

The previous entity-then-relation extraction path has been replaced by:

  • Universal graph extraction
  • Optional ontology constraints
  • Method-specific graph adapters
  • Independent graph building and indexing steps

New Graph RAG Procedures

This release adds built-in procedures and query engines for:

  • GraphRAG
  • LightRAG
  • HiRAG
  • LeanRAG

Each procedure integrates its corresponding graph construction, storage, indexing, and retrieval workflow into the Heta
Framework Recipe system.

Hierarchical Graph Capabilities

New graph capabilities include:

  • Leiden graph clustering
  • Clusterable graph-store protocols
  • Hierarchical graph aggregation
  • Community report generation
  • LeanRAG semantic aggregation
  • In-memory graph clustering

Self-Contained LightRAG and LeanRAG Support

LightRAG and LeanRAG prompts are now bundled directly with Heta Framework.

Installed packages no longer depend on adjacent LightRAG or LeanRAG source repositories, enabling clean standalone
installation and deployment.

Multi-Document Provenance

Retrieval results can now be associated with multiple source documents. BEIR evaluation handling has also been updated to
support multi-document IDs correctly.

This release also fixes MultiHop-RAG evidence recall evaluation for aggregated HiRAG results. EvidenceRecallAtK now
supports both singular and plural provenance fields:

  • source_key / source_keys
  • object_key / object_keys
  • document_id / document_ids

This enables aggregated results from GraphRAG, HiRAG, and LeanRAG to be evaluated correctly.

Installation

Install the base framework:

pip install -U heta-framework==0.1.2

Install graph construction and Graph RAG dependencies:

pip install -U "heta-framework[graph]==0.1.2"

Compatibility

  • Supports Python 3.10, 3.11, and 3.12
  • Existing Wiki and agentic query APIs from v0.1.1 remain available
  • Includes compatible versions of NetworkX, graspologic, NumPy, scikit-learn, and UMAP
  • Python 3.13 is not supported in this release

Full Changelog:
v0.1.1...v0.1.2

Assets 2
Loading