vd's job includes helping users get set up with the vectorDBs it supports. Today that surface is thin.
Current state:
_backend_metadata (vd/util.py) carries only a one-line pip_install string per backend. Several are stale / inconsistent:
pinecone → pip install pinecone-client — the PyPI package was renamed to pinecone; pinecone-client is now the deprecated shim.
- Some entries use
vd[...] extras (chroma → pip install vd[chromadb]), others use raw client package names (pinecone-client, qdrant-client, pymilvus, faiss-cpu). pyproject.toml only defines a chromadb extra.
- Server-based backends (qdrant, weaviate, milvus) need Docker or a running service — not just
pip install. There is no guidance for that anywhere.
- There is a dev skill (
vd-add-backend) and a chooser skill (vd-backend-choose), but no skill that walks a user through downloading / installing / running a vectorDB.
compare.py + vd-backend-choose use hardcoded heuristics rooted in 2024-era assumptions.
Plan (depends on the deep-research report "11 — VectorDB Selection & Setup Guide", being commissioned — see the embeddings group docs/research/semantic_search/):
This is the user-facing half of "vd as a vendor-lock-in-avoiding facade": it is not enough to abstract the API — users also need help picking and standing up a backend.
vd's job includes helping users get set up with the vectorDBs it supports. Today that surface is thin.Current state:
_backend_metadata(vd/util.py) carries only a one-linepip_installstring per backend. Several are stale / inconsistent:pinecone→pip install pinecone-client— the PyPI package was renamed topinecone;pinecone-clientis now the deprecated shim.vd[...]extras (chroma→pip install vd[chromadb]), others use raw client package names (pinecone-client,qdrant-client,pymilvus,faiss-cpu).pyproject.tomlonly defines achromadbextra.pip install. There is no guidance for that anywhere.vd-add-backend) and a chooser skill (vd-backend-choose), but no skill that walks a user through downloading / installing / running a vectorDB.compare.py+vd-backend-chooseuse hardcoded heuristics rooted in 2024-era assumptions.Plan (depends on the deep-research report "11 — VectorDB Selection & Setup Guide", being commissioned — see the embeddings group
docs/research/semantic_search/):vd-setup-backend(bundled invd/data/skills/): per-backend install / run playbooks — pip, Docker, docker-compose, embedded mode, cloud signup, and a verification step._backend_metadatafrom the report: correct install commands; addrequires_server/install_modes/ doc-link fields; definepyproject.tomlextras for each implementable backend.vd.check_requirements(backend)helper (per the user's global package-UX guideline) that diagnoses what is missing and prints the next concrete step (with optional permissioned auto-install).vd-backend-choose+compare.pyfrom the report's decision framework so the recommendation logic reflects the 2026 landscape.This is the user-facing half of "
vdas a vendor-lock-in-avoiding facade": it is not enough to abstract the API — users also need help picking and standing up a backend.