Skip to content

Agent Memory Python v0.6.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Jul 21:53
agent-memory-py-v0.6.0
99a5686
This commit was signed with the committer’s verified signature.
KIvanow Kristiyan Ivanov
GPG key ID: 4BB27D5B662BC86B
Verified
Learn about vigilant mode.

betterdb-agent-memory v0.6.0

Long-term memory tier for AI agents backed by Valkey Search — semantic recall
with recency/importance ranking, scoped capacity eviction, and consolidation.
Pairs with betterdb-agent-cache.

What's new in v0.6.0

  • consolidate() now takes a mode: the default summarization behavior, or
    mode="facts" to route to fact consolidation; unknown modes raise.
  • Fact consolidation is always available: ConsolidationConfig.enabled is
    deprecated and ignored, the config now only customizes fact_source and
    fact_importance.
  • Tombstones that match no stored fact are surfaced in
    ConsolidateFactsResult.unmatched_tombstones (plus a
    fact_tombstone_unmatched metric) instead of being silently dropped.
  • Fact subjects reconcile case- and whitespace-insensitively (subject_key,
    now exported), with deterministic first-wins dedup of case-variant
    duplicate rows.
  • Zero-hit recalls whose nearest candidate lands just above the distance
    threshold emit a recall_near_miss metric and a one-time hint, making
    too-strict thresholds visible.

Analytics (since v0.2.0)

  • Opt-out anonymous usage analytics (PostHog). Disable with
    BETTERDB_TELEMETRY=false (or 0/no/off), or per-instance via options.
    Instance id is an anonymous UUID persisted in Valkey; no payload data is sent.

Requires Valkey 8+ with the valkey-search module (vector index support).
Works with ElastiCache for Valkey, Memorystore for Valkey, and MemoryDB.

Built on betterdb-valkey-search-kit
and betterdb-agent-cache.

Installation

pip install betterdb-agent-memory

What's included

MemoryStore (long-term tier)

Method Description
ensure_index() Create or attach to the memory vector index
remember(...) Persist a memory with embedding, scope, tags, and importance
recall(...) Semantic recall ranked by similarity, recency, and importance
recall_by_vector(...) KNN recall from a precomputed vector
reinforce(id) Bump importance / recency on an existing memory
forget(...) Delete memories by id or filter
consolidate(...) Merge and summarize related memories
get(id) / list(...) Read-only fetch and scoped, paginated listing
stats() Doc count, evictions, and live config

Scoped capacity eviction, live config refresh, and discovery are built in.

AgentMemory facade

Convenience facade over betterdb-agent-cache combining the exact-match cache
tier with the long-term memory tier.

Observability

  • OpenTelemetry spans on every memory operation
  • Prometheus metrics for recall latency and eviction counts

Full changelog

See the repository history for detailed changes.

Assets 2
Loading