Skip to content

v0.8.3 — Weighted GraphRAG visualizations

Choose a tag to compare

View all tags
@jpmanson jpmanson released this 07 Aug 19:18
· 14 commits to main since this release
v0.8.3
803bfd1

Patch release focused on GraphRAG visualization and evaluation.

Why this release

The GraphRAG work added semantic proximity edges (SEMANTIC_NEAR) that are most useful when they can be inspected visually. The missing piece was that PyVis exports did not forward edge styling attributes from NetworkX, so weighted semantic relationships could not be rendered with variable thickness or richer tooltips.

Visualization

PyVis exports now preserve common edge styling attributes from NetworkX:

  • width
  • value
  • color
  • title
  • dashes
  • arrows

This enables weighted semantic graph visualizations, including SEMANTIC_NEAR edges whose thickness is derived from cosine similarity.

Example use case:

for _, _, _, edge in graph.edges(keys=True, data=True):
    score = edge["properties"]["score"]
    edge["type"] = f"SEMANTIC_NEAR\ncos={score:.2f}"
    edge["width"] = 2.0 + score * 7.0
    edge["title"] = f"cosine similarity: {score:.3f}"

GraphRAG examples

The PDF chunking Colab notebook now demonstrates:

  • materializing semantic proximity as SEMANTIC_NEAR edges
  • showing cosine similarity on semantic relationships
  • rendering semantic edge thickness based on similarity
  • comparing reading-order expansion with semantic-neighborhood expansion

Evaluation

Added a reproducible PDF GraphRAG retrieval evaluation over Anthropic's Building Effective AI Agents PDF. It compares:

  • vector top-k retrieval
  • reading-order expansion
  • semantic proximity expansion
  • hybrid retrieval
  • reranking

The evaluation is intentionally defensive: it shows that semantic graph expansion can improve evidence coverage, but also that it can add noise without reranking or context budgeting.

Compatibility

Patch release. No breaking API changes.

Existing PyVis exports keep working. If callers add supported edge attributes to the NetworkX graph before rendering, those attributes are now preserved in the generated HTML.

Validation

  • Targeted tests: 71 passed, 1 skipped
  • Full test suite before release bump: 1976 passed, 3 skipped
  • Strict docs build passes

Full Changelog: v0.8.2...v0.8.3

Assets 2
Loading