Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.
"""Method Registry - Central registry for all extraction methods.
This module provides a unified registry for method templates, enabling
consistent creation and management of method-based knowledge extraction.
"""
from typing import Any
from pydantic import BaseModel
_METHOD_REGISTRY: dict[str, dict[str, Any]] = {}
def register_method(
name: str,
method_class: type,
autotype: str,
description: str = "",
) -> None:
"""Register a method in the registry.
Args:
name: Method name (e.g., "light_rag")
method_class: The method class
autotype: AutoType category (e.g., "graph", "hypergraph")
description: Method description
"""
_METHOD_REGISTRY[name] = {
"class": method_class,
"type": autotype,
"description": description,
}
def get_method(name: str) -> dict[str, Any] | None:
"""Get method info by name.
Args:
name: Method name
Returns:
Method info dict or None if not found
"""
return _METHOD_REGISTRY.get(name)
def list_methods() -> dict[str, dict[str, Any]]:
"""List all registered methods.
Returns:
Dict mapping method names to their info
"""
return _METHOD_REGISTRY.copy()
class MethodCfg(BaseModel):
"""Configuration model for method templates."""
name: str
type: str
description: str = ""
def get_method_cfg(name: str) -> MethodCfg | None:
"""Get method configuration as MethodCfg.
Args:
name: Method name
Returns:
MethodCfg or None if not found
"""
info = get_method(name)
if info is None:
return None
return MethodCfg(
name=name,
type=info["type"],
description=info["description"],
)
def list_method_cfgs() -> dict[str, MethodCfg]:
"""List all method configurations.
Returns:
Dict mapping "method/{name}" to MethodCfg
"""
return {
f"method/{name}": MethodCfg(
name=name,
type=info["type"],
description=info["description"],
)
for name, info in _METHOD_REGISTRY.items()
}
def _init_registry():
"""Initialize the registry with built-in methods."""
from hyperextract.methods.rag import (
Chunk_RAG,
Cog_RAG,
Graph_RAG,
Hyper_RAG,
HyperGraph_RAG,
Light_RAG,
)
from hyperextract.methods.typical import Atom, KG_Gen, iText2KG, iText2KG_Star
register_method(
name="chunk_rag",
method_class=Chunk_RAG,
autotype="document",
description=(
"Chunk RAG: baseline retrieval over raw text chunks (no LLM extraction)"
),
)
register_method(
name="graph_rag",
method_class=Graph_RAG,
autotype="graph",
description="Graph-RAG: Graph-based Retrieval-Augmented Generation with Community detection",
)
register_method(
name="light_rag",
method_class=Light_RAG,
autotype="graph",
description="Lightweight Graph-based RAG with binary edges for entity-relationship extraction",
)
register_method(
name="hyper_rag",
method_class=Hyper_RAG,
autotype="hypergraph",
description="Hypergraph-based RAG with n-ary hyperedges for complex multi-entity relationships",
)
register_method(
name="hypergraph_rag",
method_class=HyperGraph_RAG,
autotype="hypergraph",
description="HyperGraph RAG implementation for advanced knowledge graph construction",
)
register_method(
name="cog_rag",
method_class=Cog_RAG,
autotype="hypergraph",
description="Cognitive RAG implementation for intelligent knowledge retrieval",
)
register_method(
name="itext2kg",
method_class=iText2KG,
autotype="graph",
description="iText2KG: High-quality triple-based knowledge graph extraction",
)
register_method(
name="itext2kg_star",
method_class=iText2KG_Star,
autotype="graph",
description="iText2KG Star: Enhanced version with improved extraction quality",
)
register_method(
name="kg_gen",
method_class=KG_Gen,
autotype="graph",
description="KG_Gen: Knowledge Graph Generator for structured knowledge extraction",
)
register_method(
name="atom",
method_class=Atom,
autotype="graph",
description="Atom: Temporal knowledge graph extraction with evidence attribution",
)
_init_registry()