feat: add Valkey vector store integration

.env-template

@@ -37,3 +37,14 @@ MICROSOFT_AUTHORITY=https://{tenantId}.ciamlogin.com/{tenantId}
 
 
 # POSTGRES_URI=postgresql://docsgpt:docsgpt@localhost:5432/docsgpt
+
+# Valkey Vector Store (set VECTOR_STORE=valkey to use)
+# VALKEY_HOST=localhost
+# VALKEY_PORT=6379
+# VALKEY_PASSWORD=
+# VALKEY_USE_TLS=false
+# VALKEY_INDEX_NAME=docsgpt
+# VALKEY_PREFIX=doc:
+# VALKEY_DISTANCE_METRIC=cosine  # cosine, l2, or ip
+# VALKEY_VECTOR_TYPE=float32  # float32 (only option in valkey-glide-sync 2.x)
+# VALKEY_VECTOR_ALGORITHM=hnsw  # hnsw or flat

application/core/settings.py

@@ -69,7 +69,7 @@ class Settings(BaseSettings):
     # Pages docling's threaded pipeline buffers in flight; the library
     # default (100) drives worker RSS to ~3 GB on a mid-size PDF.
     DOCLING_PIPELINE_QUEUE_MAX_SIZE: int = 2
-    VECTOR_STORE: str = "faiss"  #  "faiss" or "elasticsearch" or "qdrant" or "milvus" or "lancedb" or "pgvector"
+    VECTOR_STORE: str = "faiss"  #  "faiss" or "elasticsearch" or "qdrant" or "milvus" or "lancedb" or "pgvector" or "valkey"
     RETRIEVERS_ENABLED: list = ["classic_rag"]
     AGENT_NAME: str = "classic"
     FALLBACK_LLM_PROVIDER: Optional[str] = None  # provider for fallback llm
@@ -165,6 +165,18 @@ class Settings(BaseSettings):
     LANCEDB_PATH: str = "./data/lancedb"  # Path where LanceDB stores its local data
     LANCEDB_TABLE_NAME: Optional[str] = "docsgpts"  # Name of the table to use for storing vectors
 
+    # Valkey vectorstore config
+    VALKEY_HOST: str = "localhost"
+    VALKEY_PORT: int = 6379
+    VALKEY_PASSWORD: Optional[str] = None
+    VALKEY_USE_TLS: bool = False
+    VALKEY_INDEX_NAME: str = "docsgpt"
+    VALKEY_PREFIX: str = "doc:"
+    VALKEY_REQUEST_TIMEOUT: int = 5000  # milliseconds
+    VALKEY_DISTANCE_METRIC: str = "cosine"  # "cosine", "l2", or "ip"
+    VALKEY_VECTOR_TYPE: str = "float32"  # "float32" (only option in valkey-glide-sync 2.x)
+    VALKEY_VECTOR_ALGORITHM: str = "hnsw"  # "hnsw" or "flat"
+
     FLASK_DEBUG_MODE: bool = False
     STORAGE_TYPE: str = "local"  # local or s3
 

application/requirements.txt

@@ -103,6 +103,7 @@ tzdata==2026.1
 urllib3==2.6.3
 uvicorn[standard]>=0.30,<1
 uvicorn-worker>=0.4,<1
+valkey-glide-sync==2.3.1
 vine==5.1.0
 wcwidth==0.6.0
 werkzeug>=3.1.0