Skip to content

v2.0.0

Choose a tag to compare

@tuancookiez-hub tuancookiez-hub released this 30 Jun 20:51

HyAtlas Memory v2.0.0

What's New

  • L5 in-process knowledge graph writer — entities extracted into Qdrant during System2 digest (no subprocess batch lock)
  • L6 schemas + L7 intentions — schemas and intentions written to Kuzu graph with cross-domain collision detection
  • Robust S2 JSON parser (Patch 18) — fixes LLM think-block wrapping that blocked all L6/L7 writes
  • L4 identity dedup — pre-write cosine dedup, identity_type, evolution chains
  • Hybrid v2 reader — better retrieval than the legacy pipeline
  • Dashboard real graph counts — L5/L6/L7 counts from live Kuzu data
  • 1024-d embeddings — bge-large-en-v1.5 (upgraded from 384-d)

Bug Fixes (post-release)

  • Patch 20: S1 extractor entity_type crash — every S1 extract call was throwing KeyError because l5_kuzu_export.json uses 'type' but the extractor expected 'entity_type'. This silently killed all new L2 fact creation and froze L6/L7 growth.
  • Dashboard graph-counts limit cap — /api/graph-counts endpoint still had limit=200 (the other endpoint was already fixed to 10000). Dashboard showed truncated counts for users with >200 graph nodes.
  • PYTHONHOME cleanup — child processes now clear PYTHONHOME to prevent interpreter conflicts on multi-Python Windows systems.

Installation

git clone https://github.com/tuancookiez-hub/HyAtlas-Memory.git
cd HyAtlas-Memory
pip install -e .
hyatlas setup hermes

Breaking Changes

  • Embedding dimension: 384 → 1024 (existing 384-d collections need migration)
  • Kuzu graph dims must match new embedder
  • New env defaults: HY_MEMORY_READER=hybrid_v2, MEMORY_L5_VERSION=2

Migration from v1.x

See docs/MIGRATION_v2_SCLASS.md

Known Limitations

  • Kuzu WAL accumulates until clean hyatlas stop — recommend periodic restarts
  • rerank_stage patch silently no-ops against current upstream reader API

Full Changelog

See CHANGELOG.md