#1300·llmware

feat: 将 Valkey 添加为向量数据库选项 (使用 Valkey GLIDE)

作者: MatthiasHowellYopp创建于 2026年5月15日更新于 2026年5月15日

□ 总结

在llmware中添加Valkey作为支持的矢量数据库,使用官方Valkey GLIDE同步客户端("valkey-glide-sync").

相关讨论:1296号

□动机

  • Valkey是Redis的开源(BSD-3-Clause)后继者,由Linux基金会支持
  • valkey-search模块提供与HNSW/FLAT索引的矢量相似性搜索,外加全文、标记和数字范围查询
  • 云母:AWSE 阿拉斯提切 9.0+和Google CloudE 内存存储器同时支持 Valkey 并进行矢量搜索
  • 现有的Embedding Redis ' 类使用Redis-py',目标是SSPL许可的Redis服务器;

□ 执行

按照现有的模式(Embedding Redis'、Embedding Milvus'等):

  • configs.py'中的Valkey Config ' ——主机、端口、证书、TLS(全部支持)
  • EmbeddingValkey' in embeddings.py'——执行创建-新-embedding'、search-index'、`delete-index'的独立类别
  • ** 登记** — “valkey”添加到VectorDB Registry'和支持的'[vector db']`
  • ** 依赖性** -- -- `valkey-glide-sync'(懒惰进口,可选)
  • ** 测试**——配置/登记单位测试+创建/搜索/删除综合测试

□ 要求

  • Valkey服务器 QQ 9.1 带有Valkey搜索模块 QQ 1.2.0
  • Python:`pip安装valkey-glide-sync'(v2.3.1+,支持Python 3.9-3.13)
  • 用于试验的Docker:`Docker跑-d-p 6379:6379 valkey/valkey-bundle:9.1.0-rc2'

□ 设计决定

  1. 单独类——API与GLIDE对Redis-py的区别使得共享基不切实际.
  2. ** 只同步客户端** — 匹配所有其他嵌入类所用的同步模式
  3. ** 无分组模式**——仅供初步执行。
  4. Individual hset写作 — HNSW索引进程同步写作,导致批量/管线超时;个人通话可靠并符合"Embedding Redis"模式

内容来源: llmware-ai/llmware