Skip to content

Conversation

@doubleinfinity
Copy link

Description

This pull request adds the ZeusDB vector store integration to LlamaIndex.

ZeusDB is a high-performance, Rust-powered vector database that provides enterprise-grade retrieval capabilities, product quantization (PQ), and persistent storage.

This integration allows users to leverage ZeusDB within LlamaIndex for scalable and efficient vector storage, retrieval, and querying in RAG pipelines.

Changes

Main package integration files
llama-index-integrations/vector_stores/llama-index-vector-stores-zeusdb
→ Includes all required integration files generated from the official LlamaIndex CLI scaffold.

Added new files
docs/examples/vector_stores/ZeusDBIndexDemo.ipynb
→ Demonstrates ZeusDB integration and usage through Jupyter Notebook examples.

Modified existing files
docs/src/content/docs/framework/module_guides/storing/vector_stores.md
docs/src/content/docs/framework/community/integrations/vector_stores.md
→ Added ZeusDB to the vector store documentation and integration listings.

PyPI Package Alignment

The package is already published on PyPI as llama-index-vector-stores-zeusdb.
The integration code and PyPI package code are fully synchronized with this pull request.

Could you please confirm the PyPI username or organization name associated with the official LlamaIndex account so the package can be transferred to your ownership?

Fixes # (issue): N/A

New Package?

Did I fill in the tool.llamahub section in the pyproject.toml and provide a detailed README.md for my new integration or package?

  • Yes
  • No

Version Bump?

Did I bump the version in the pyproject.toml file of the package I am updating? (Except for the llama-index-core package)

  • Yes
  • No

Type of Change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

Your pull-request will likely not be merged unless it is covered by some form of impactful unit testing.

  • I added new unit tests to cover this change
  • I believe this change is already covered by existing unit tests

Suggested Checklist:

  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added Google Colab support for the newly added notebooks.
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • I ran uv run make format; uv run make lint to appease the lint gods

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@dosubot dosubot bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Oct 30, 2025
)

# Try to import the real base, else provide a minimal stub
try:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are there so many try/except imports? Generally all these should be covered assuming the pyproject.toml is setup correctly

else:
if dim is None:
raise ValueError("dim is required when not providing zeusdb_index")
# Defer zeusdb import to runtime
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why?

ids.append(_id)
sims.append(_similarity_from_distance(dist, self._space))

from llama_index.core.vector_stores.types import ( # type: ignore
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please avoid nested imports

# Try real llama_index.core first
# ----------------------------------------
try:
import llama_index.core.vector_stores.types # type: ignore # noqa: F401
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

core is a dependency in the toml. Why wouldn't it be installed?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants