Skip to main content

ragleap-vectorstores

Pluggable vector backends beyond ragleap-rag's built-in 6 (PgVector, FAISS, Pinecone, Weaviate, Qdrant, Milvus).

This package is under active development - more backends will be added over time. See the roadmap for status.

Available backends

Backend Extra Notes
Chroma chroma Embedded/local via chromadb's PersistentClient - no server required. No native sparse/keyword search (supports_sparse() is False); hybrid search falls back to dense-only.
LanceDB lancedb Embedded/local via a directory path - no server required. Real upsert semantics via merge_insert(). No native sparse/keyword search enabled yet (supports_sparse() is False); hybrid search falls back to dense-only.
Redis redis Requires a real running server - Redis Stack, or plain Redis with the RediSearch module loaded (no embedded/local mode). init_schema() checks for the module and raises a clear error if it's missing. Metadata filtering only supports document_id (RediSearch requires predeclared schema fields). No native sparse/keyword search enabled yet (supports_sparse() is False); hybrid search falls back to dense-only.
Upstash Vector upstash Managed serverless REST API - no embedded/local mode at all, and the index (fixed dimension, dense-vs-hybrid type) must already exist, created via the Upstash console; init_schema() verifies compatibility via info() rather than creating anything. Metadata filtering supports arbitrary multi-key filters natively (real SQL-like filter= string over a genuine JSON dict) - more flexible than Redis here. No native sparse/keyword search enabled yet (supports_sparse() is False); hybrid search falls back to dense-only.
OpenSearch opensearch Requires a real running OpenSearch instance (no embedded/local mode); uses OpenSearch's native k-NN vector search with the lucene engine (the nmslib engine is rejected on OpenSearch 3.0+). The document registry is a second OpenSearch index. Metadata filtering supports arbitrary term/range filters over any mapped field. No native sparse/keyword search enabled yet (supports_sparse() is False); hybrid search falls back to dense-only.

Design

Every backend here implements ragleap-rag's VectorBackend interface, so it can be passed directly to RagLeap(vector_backend=...). Each backend's real client SDK is an optional extra - installing ragleap-vectorstores alone pulls in no heavy dependencies beyond ragleap-rag itself.

Install

pip install ragleap-vectorstores[chroma]
# or, with uv
uv add ragleap-vectorstores[chroma]

pip install ragleap-vectorstores[lancedb]
# or, with uv
uv add ragleap-vectorstores[lancedb]

pip install ragleap-vectorstores[opensearch]
# or, with uv
uv add ragleap-vectorstores[opensearch]

Usage

from ragleap_vectorstores import ChromaBackend

backend = ChromaBackend(persist_directory="./chroma_data")
from ragleap_vectorstores import LanceDBBackend

backend = LanceDBBackend(uri="./lancedb_data")
from ragleap_vectorstores import RedisBackend

# Requires a real Redis Stack instance (or plain Redis + the RediSearch
# module) - plain Redis alone has no vector search.
backend = RedisBackend(redis_url="redis://localhost:6379/0")
from ragleap_vectorstores import UpstashBackend

# Requires a real Upstash Vector index, created via the Upstash console
# (console.upstash.com) as a pure DENSE index - no embedded/local mode.
backend = UpstashBackend(url="https://...upstash.io", token="...")
from ragleap_vectorstores import OpenSearchBackend

# Requires a real running OpenSearch instance (e.g. http://localhost:9200) -
# no embedded/local mode. Pass http_auth=("user", "password") and
# use_ssl=True for a secured cluster.
backend = OpenSearchBackend(opensearch_url="http://localhost:9200")

Metadata

Release files for ragleap-vectorstores 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ragleap-vectorstores 0.6.0
File Size Uploaded Provenance
ragleap_vectorstores-0.6.0.tar.gz 31.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ragleap-vectorstores 0.6.0
File Interpreter ABI Platform
ragleap_vectorstores-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 56.9 kB

Release files / ragleap_vectorstores-0.6.0.tar.gz

Download URL ragleap_vectorstores-0.6.0.tar.gz
Size 31.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8df180ec61c39197cd9d6f2501f12ce501f72db8aad9288459955f65c289f2e5
BLAKE2b-256 checksum
How to use checksums
1b37d4018f971cf76cf31113439ff6633f4b227d0850edeb74f8a5f3ba50eb49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / ragleap_vectorstores-0.6.0-py3-none-any.whl

Download URL ragleap_vectorstores-0.6.0-py3-none-any.whl
Size 25.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7e2ae857fb2e6b71ea8b17680fe8122b01f4c41e8da717bdc37123735cca04f5
BLAKE2b-256 checksum
How to use checksums
7833a7faa1a6d76bd4eeb244f09503beffa7a349c96e2bee821ef3692c74698c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for ragleap-vectorstores 0.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ragleap_vectorstores-0.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page