feat: add MimirMemoryService + Perseus live context sample#6169
Closed
tcconnally wants to merge 4 commits into
Closed
feat: add MimirMemoryService + Perseus live context sample#6169tcconnally wants to merge 4 commits into
tcconnally wants to merge 4 commits into
Conversation
Adds a Mimir-backed memory service implementation that extends BaseMemoryService. Mimir (github.com/Perseus-Computing-LLC/mimir, MIT-licensed) provides 30 MCP tools with FTS5+dense hybrid search and optional AES-256-GCM encryption — no cloud dependencies. - talks to the mimir binary via JSON-RPC over stdin/stdout (MCP stdio) - implements add_session_to_memory, add_events_to_memory, add_memory, and search_memory - thread-safe with subprocess isolation - graceful fallback when mimir binary is not found Also adds a Perseus live context sample under contributing/samples/context_management/perseus_context/ demonstrating workspace-aware agents via before_agent_callback + perseus-ctx. Refs: google#6131, google#6132
tcconnally
force-pushed
the
feat/mimir-perseus-adk-integration
branch
from
4d2f971 to
9bc71a3
Compare
The Google header-check bot requires all new Python files to include the Apache 2.0 license header, even empty __init__.py files.
adk-bot
added
the
services
rohityan
added
the
community repo
Collaborator
|
Hi @tcconnally , Thank you for your contribution! We appreciate you taking the time to submit this pull request. |
tcconnally
added a commit
to Perseus-Computing-LLC/adk-mimir-memory
that referenced
this pull request
Jun 26, 2026
- MimirMemoryService: persistent cross-session memory for Google ADK - Backed by Mimir (MIT) — 30+ MCP tools, FTS5+dense hybrid search, AES-256-GCM - Perseus context agent sample with before_agent_callback - Zero cloud dependencies, fully local SQLite backend - Apache-2.0 → MIT (standalone package, original implementation) Closes google/adk-python#6131, google/adk-python#6132 See also: google/adk-python#6169 (closed — migrated to standalone)
Author
|
Thanks for the review @rohityan! Following your recommendation, I've released this as a standalone package: 📦 adk-mimir-memory — https://github.com/Perseus-Computing-LLC/adk-mimir-memory pip install adk-mimir-memoryThe package includes:
Next step: would love to get this listed on https://google.github.io/adk-docs/integrations/. Happy to follow whatever submission process is needed — let me know if there's a PR template or form for integration listings. Also happy to submit a PR to |
koverholt
added a commit
to google/adk-docs
that referenced
this pull request
Jun 26, 2026
…y for ADK (#1877) * feat(integrations): add Mimir Memory — persistent cross-session memory for ADK Adds MimirMemoryService integration documentation: - Persistent, local, encrypted memory backend for ADK agents - AES-256-GCM encryption, FTS5+dense hybrid search - Zero cloud dependencies — single Rust binary + SQLite - Includes Perseus live context agent sample - Backend comparison table vs InMemory, VertexAi, RAG Package: https://github.com/Perseus-Computing-LLC/adk-mimir-memory Refs: google/adk-python#6169 * Formatting edits * Fix Mimir Memory code samples, install steps, and comparison table * Fix unrelated link failure for Arize Phoenix * Add link to PyPI package --------- Co-authored-by: Kristopher Overholt <koverholt@google.com>
Collaborator
|
Hi @tcconnally , You can find additional guidance at https://github.com/google/adk-docs/blob/main/CONTRIBUTING.md |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds two integrations requested in #6131 and #6132:
1.
MimirMemoryService— persistent cross-session memoryImplements
BaseMemoryServicebacked by Mimir (MIT-licensed, 30 MCP tools, FTS5+dense hybrid search, optional AES-256-GCM encryption).mimirbinary via JSON-RPC over stdin/stdout (MCP stdio transport)add_session_to_memory,add_events_to_memory,add_memory,search_memoryCompared to existing backends:
2. Perseus live context sample
Demonstrates using Perseus (MIT-licensed live context engine) to give ADK agents real-time workspace awareness via
before_agent_callback.@file,@search,@memory) at inference timeTesting
InMemoryMemoryServicecoverage pattern)pip install perseus-ctxCloses: #6131, #6132