feat: add Valkey support (storage db + vector db)#8141
Merged
harshsinha03 merged 15 commits intoJul 13, 2026
Conversation
Signed-off-by: Edward Liang <edward.liang@improving.com>
…ntification Signed-off-by: Anna Tao <annatao2004@gmail.com>
kausmeows
reviewed
Jul 3, 2026
kausmeows
reviewed
Jul 3, 2026
9f56cdd to
db9a83f
Compare
kausmeows
reviewed
Jul 3, 2026
kausmeows
reviewed
Jul 3, 2026
kausmeows
reviewed
Jul 3, 2026
kausmeows
reviewed
Jul 3, 2026
Contributor
|
Hi @atao2004, thanks for this addition! We'll get this merged soon. Would you also be open to adding the docs for this here: https://github.com/agno-agi/docs? |
- Remove culture_table support (deprecated); add learnings_table - Make client_name configurable with sensible defaults - Fix ServerCredentials: raise ValueError on username-without-password - Add docker instructions to cookbook - Expand table_exists() docstring (schemaless DB explanation) - Add dict-based metadata filtering for indexed tag fields in vectordb Signed-off-by: Anna Tao <annatao2004@gmail.com>
Contributor
Author
|
Thanks for the review @kausmeows all feedback addressed in commit 3c659af: |
4 tasks
Contributor
Author
|
Hi @harshsinha03 added docs here agno-agi/docs#700 :) |
…tname # Conflicts: # libs/agno/pyproject.toml
…ved culture_table
Signed-off-by: Edward Liang <edward.liang@improving.com>
harshsinha03
approved these changes
Jul 13, 2026
16 tasks
harshsinha03
added a commit
to agno-agi/docs
that referenced
this pull request
Jul 14, 2026
## Summary Adds documentation for the Valkey integration (storage adapter + vector database), companion to [agno-agi/agno#8141](agno-agi/agno#8141). ### Storage adapter (`database/providers/valkey/`) - Overview with Docker setup, basic usage, and configuration params - Usage examples: agent, team, workflow storage ### Vector database (`knowledge/vector-stores/valkey/`) - Overview with setup (requires `valkey/valkey-bundle` for search module) - Code example with Knowledge + Agent - Metadata filtering documentation (dict-based on indexed TAG fields) - Configuration params table ### Notes - `database/valkey.mdx` is a leftover from an incorrect initial placement — should be deleted (the correct file is at `database/providers/valkey/overview.mdx`) - `docs.json` navigation entries need to be added for the Valkey pages (happy to do this if you point me to the right section structure) - No `<Snippet>` param files created yet — used inline tables instead. Happy to refactor to snippets if preferred. ## Checklist - [x] Follows existing doc structure (mirrors Redis docs) - [x] Code examples use correct imports from the Valkey adapter - [x] Docker instructions included - [x] Configuration parameters documented --------- Co-authored-by: Harsh Sinha <sinha03harsh@gmail.com>
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
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 full Valkey support to Agno: a
ValkeyDbstorage adapter, aValkeyDBvector database, cookbooks, and unit/integration tests. Both clients set aclient_nameso connections are identifiable viaCLIENT LISTon the server.Closes #8117, closes #7795
Storage adapter (
agno/db/valkey)ValkeyDbimplementing the fullBaseDbinterface: sessions, user memories, metrics, evals, knowledge, cultural knowledge, traces, and spans.valkey-glide-sync(GlideClient/GlideClusterClient), with support for host/port, username/password auth, TLS, logical database selection, or a pre-configured client instance.user_id,agent_id,session_type,trace_id) for filtered lookups without full scans.upsert_sessions,upsert_memories,delete_sessions,create_spans,delete_eval_runs) batched through GLIDE pipelines, with per-record write verification.expire.agno_db_client(CLIENT SETNAME).Vector database (
agno/vectordb/valkey)ValkeyDB(exported aliasValkeyVectorDb) implementing theVectorDbinterface using the valkey-search module (FT.*commands).agno_vectordb_client.Cookbooks
cookbook/06_storage/valkey/— agent, team, and workflow storage examples with README.cookbook/05_agent_os/dbs/valkey_db.py— AgentOS backed by Valkey.cookbook/07_knowledge/05_integrations/vector_dbs/05_valkey.py— knowledge base with Valkey as the vector store.Tests
Dependencies
valkeyextra:valkey-glide-sync>=2.1.0, included in thestorageandvectordbsextras.Run Valkey locally with:
Type of change
Checklist
./scripts/format.shand./scripts/validate.sh)Duplicate and AI-Generated PR Check
Additional Notes
valkey/valkey-bundleDocker image is required for vector search (it ships the valkey-search module); plainvalkey/valkeyis sufficient for the storage adapter.