Skip to content

v0.1.0

Choose a tag to compare

@arrry-hydraDB arrry-hydraDB released this 09 Nov 18:28
· 342 commits to main since this release
pip install -U selfgraph
  • Entity resolution: fold a new entity into a stored one that names the same thing. Modes are exact (default), default (shared external id or alias), fuzzy (similar names) and llm (an LLM confirms close pairs). Every merge is recorded and can be undone with unmerge. Available as --resolver in the CLI and as entity_merges and unmerge_entity in MCP.
  • Contradictions: a schema can cap relations per entity with max_count, e.g. one employer per person. A newer fact that breaks the cap warns by default. In supersede mode the older fact is retired with invalidated_at and stays in history. relation list --include-invalidated shows retired relations.
  • as_of reads: retrieve(as_of=...) and --as-of read the graph as it was at a given time.
  • Maintenance: decay scores items by recency and frequency, prune removes weak or old items, and consolidate merges duplicate parallel relations. All three only show the plan unless you pass --apply (dry_run=False in the SDK).
  • Neo4j schema interop: selfgraph schema import and selfgraph schema export convert to and from a Neo4j graph schema.
  • Evidence: every entity and relation records the source text that supports it (entity evidence, relation evidence).
  • Schema checks now also apply to single create and update calls. The schema also supports min_count/max_count, parent types and required properties.
  • HydraDB 0.4: writes are batched.
  • CLI: versions subcommands, retrieve --context-only, connection flags after the subcommand, inline JSON for --schema, progress on stderr, and settings checked before connecting.
  • Fixes: HydraDB now clears emptied fields, re-inserting an old fact no longer retires a newer one, alias-form ids map to the real entity, and an invalid LLM key or model now fails with an error instead of silently producing an empty graph.

Breaking changes

  • The llm extra no longer installs mcp. Use pip install "selfgraph[mcp]" for the MCP server.
  • List cursors are now id-based. Cursors saved from 0.0.x no longer work.
  • A time without a timezone is read as UTC.
  • CLI exit codes: 2 for invalid input, 1 for runtime errors, 130 when interrupted.

Docs: https://github.com/hydra-db/selfgraph#readme