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.5.2

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.5.2
File Size Uploaded Provenance
ragleap_vectorstores-0.5.2.tar.gz 29.0 kB With provenance Details

Built distribution (wheel)

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

Total release size: 53.6 kB

Release files / ragleap_vectorstores-0.5.2.tar.gz

Download URL ragleap_vectorstores-0.5.2.tar.gz
Size 29.0 kB
Tags Source
SHA-256 checksum
How to use checksums
688c3a54f595fd0ff58beeab730a47e995ef61b72002f8e270f840f322f6533f
BLAKE2b-256 checksum
How to use checksums
a3923ba9133a827cb28981711fdce6a98ce45976b37e1257dc5a3046d8274ea0
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 19, 2026.

Transparency log

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

Download URL ragleap_vectorstores-0.5.2-py3-none-any.whl
Size 24.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cab1c7038f556568a7964e7f7427213310ef3d4cbffdfde12f412955a35f3f90
BLAKE2b-256 checksum
How to use checksums
bd7fbedad42288446579c5038bdf69aacf8bf5d17fbe33f8ed4381f970aae504
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 19, 2026.

Transparency log

Security for ragleap-vectorstores 0.5.2

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.5.2.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 19, 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