xyberos-qdrant
Qdrant VectorStore plugin — RFC-0019, M4. Hosted or local Qdrant
as an xyberos VectorStore. Passes the same parity scenarios as the stdlib
SqliteVectorStore (the M4 Definition of Done).
Install
pip install -e ./qdrant
pip install qdrant-client # or: pip install xyberos[vectors]
Usage
from xyberos import create_app
from xyberos_qdrant import QdrantPlugin
app = create_app()
app.load_plugin(QdrantPlugin(location=":memory:")) # local, no infrastructure
# hosted: QdrantPlugin(url="https://...", api_key=os.getenv("QDRANT_API_KEY"))
store = app.resolve("vector_store")
store.upsert("ns", "doc-1", [1.0, 0.0, 0.0, 0.0], {"text": "alpha"})
hits = store.query("ns", [1.0, 0.0, 0.0, 0.0], top_k=3)
Or configure through the environment (QDRANT_URL, QDRANT_API_KEY,
QDRANT_DIM) and let the xyberos.plugins entry point register it.
Design
- Each namespace maps to a Qdrant collection using cosine distance
(higher score = more relevant, matching the
VectorStorecontract). - The client is imported lazily and a clear
ProviderErroris raised whenqdrant-clientis missing. - Arbitrary string ids are mapped to deterministic UUIDs (Qdrant point ids are
int/UUID); the original id round-trips through the payload, so the contract's string ids hold exactly.
Tests
pip install pytest
pytest tests/ # unit + parity + plugin tests
Parity tests run against Qdrant's in-memory local mode, so they need no
server; they skip cleanly if qdrant-client is absent.
Ship location
[vectors] extra (qdrant-client already added to pyproject.toml).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xyberos_qdrant-0.1.0.tar.gz.
File metadata
- Download URL: xyberos_qdrant-0.1.0.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca6c5b98c57fe1a6fb5945a06b369f2df03720cca71c664a0b9053576507a782
|
|
| MD5 |
eb16ff3d549cd3b3041256209f298c65
|
|
| BLAKE2b-256 |
7a52cb065887a35c07f05d8ccbe4faa652420e52c8392de9dae34a3c07bdcc5e
|
Provenance
The following attestation bundles were made for xyberos_qdrant-0.1.0.tar.gz:
Publisher:
pypi-plugins.yml on xyberos/xyberos-plugins
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xyberos_qdrant-0.1.0.tar.gz -
Subject digest:
ca6c5b98c57fe1a6fb5945a06b369f2df03720cca71c664a0b9053576507a782 - Sigstore transparency entry: 2495324891
- Sigstore integration time:
-
Permalink:
xyberos/xyberos-plugins@cd98ad6193005275396bb763df8de0468830de4a -
Branch / Tag:
refs/heads/master - Owner: https://github.com/xyberos
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-plugins.yml@cd98ad6193005275396bb763df8de0468830de4a -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file xyberos_qdrant-0.1.0-py3-none-any.whl.
File metadata
- Download URL: xyberos_qdrant-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb05297e7023625efa5f994a15ee85ab74544948371c7f1cf3f13de6b5314528
|
|
| MD5 |
007a455983b43afa28abe38ffc0647b3
|
|
| BLAKE2b-256 |
1591b2b7edabe2a4d92dee0a1283930ca2f0474dd5222768c56e5390dc2207ce
|
Provenance
The following attestation bundles were made for xyberos_qdrant-0.1.0-py3-none-any.whl:
Publisher:
pypi-plugins.yml on xyberos/xyberos-plugins
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xyberos_qdrant-0.1.0-py3-none-any.whl -
Subject digest:
cb05297e7023625efa5f994a15ee85ab74544948371c7f1cf3f13de6b5314528 - Sigstore transparency entry: 2495325192
- Sigstore integration time:
-
Permalink:
xyberos/xyberos-plugins@cd98ad6193005275396bb763df8de0468830de4a -
Branch / Tag:
refs/heads/master - Owner: https://github.com/xyberos
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-plugins.yml@cd98ad6193005275396bb763df8de0468830de4a -
Trigger Event:
workflow_dispatch
-
Statement type: