pyqql
Native Python bindings for QQL (parser, plan, execute) via PyO3.
Proposition
Write Qdrant operations as QQL instead of hand-built JSON. Same language as the
CLI and other SDKs: hybrid search, multitenancy (inject_filter + SHARD),
schema-as-code, REST or gRPC.
Install
pip install pyqql
Python 3.8+ (stable ABI wheels). REST + gRPC included.
Quick start
import pyqql
embedder = pyqql.HttpEmbedder(
endpoint="http://localhost:11434/v1/embeddings",
model="all-minilm:l6-v2",
dimension=384,
)
client = pyqql.Client("http://localhost:6333", embedder=embedder)
report = client.execute(
"QUERY TEXT 'cardiology' FROM medical_records USING dense LIMIT 5"
)
print(report) # ExecutionReport: ok, results[], succeeded, failed
# Isolation (always on untrusted QQL)
stmt = pyqql.parse("QUERY TEXT 'risks' FROM sec10k USING dense LIMIT 10")[0]
pyqql.inject_filter(stmt, "tenant_id", "=", "honeywell")
# Routing (custom sharding): prefer SHARD in QQL, or set after parse
# QUERY ... SHARD 'honeywell' LIMIT 10
stmt.shard_key = "honeywell"
client.execute(stmt)
API summary
| Export | Role |
|---|---|
Client(url, api_key=None, use_grpc=False, embedder=None) |
Execute against Qdrant |
HttpEmbedder(endpoint, model, dimension, api_key="") |
OpenAI-compatible embeddings |
parse / is_valid / tokenize |
Frontend |
inject_filter(query|Stmt, field, op, value) |
Host isolation (AST) |
Stmt.shard_key |
Same field as QQL SHARD '…' (get/set; no inject_shard_key) |
compile_query / explain |
Offline plan / REST projection |
execute / execute_async |
One-shot free functions |
inject_filter operators
Accepted: =, >, >=, <, <= (and aliases).
Rejected: !=, IN, … — write those in QQL or inject equality only.
Isolation vs routing
| Concern | API | Wire |
|---|---|---|
| Isolation | inject_filter / WHERE |
REST/gRPC Filter |
| Routing | SHARD '…' or stmt.shard_key |
REST shard_key / gRPC ShardKeySelector |
| Partition DDL | CREATE SHARD KEY '…' |
Admin shard-key API |
Execution report
{
"ok": True,
"results": [{"ok": True, "operation": "QUERY", "message": "…", "data": …}],
"succeeded": 1,
"failed": 0,
}
on_error="stop" (default) or "continue".
Docs
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distributions
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 pyqql-0.1.5-cp38-abi3-win_amd64.whl.
File metadata
- Download URL: pyqql-0.1.5-cp38-abi3-win_amd64.whl
- Upload date:
- Size: 3.4 MB
- Tags: CPython 3.8+, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
416c675f866c7c086957d7f17af3400598ac314fbe356b417b8944def8b00cc2
|
|
| MD5 |
b2f04dc978ad8e574786708afec862fb
|
|
| BLAKE2b-256 |
1dd6138325d009890ab696ed26e540279dbff65a497f5f170db39198d1114bc4
|
Provenance
The following attestation bundles were made for pyqql-0.1.5-cp38-abi3-win_amd64.whl:
Publisher:
release.yml on srimon12/qql-rs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyqql-0.1.5-cp38-abi3-win_amd64.whl -
Subject digest:
416c675f866c7c086957d7f17af3400598ac314fbe356b417b8944def8b00cc2 - Sigstore transparency entry: 2291622918
- Sigstore integration time:
-
Permalink:
srimon12/qql-rs@815128143b9b6364d52ee8af40137837fff0472f -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/srimon12
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@815128143b9b6364d52ee8af40137837fff0472f -
Trigger Event:
push
-
Statement type:
File details
Details for the file pyqql-0.1.5-cp38-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: pyqql-0.1.5-cp38-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 3.3 MB
- Tags: CPython 3.8+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b279ec576053f55f24a2323f1f705ea65e1b22bbb09e23425446432602e0787b
|
|
| MD5 |
53cd87229a39baa750b3aa3fb27737dd
|
|
| BLAKE2b-256 |
f57fd980cf4d8b8e970e623b0b80e956cbbb45b39b6a993e957c72ed9307d4da
|
Provenance
The following attestation bundles were made for pyqql-0.1.5-cp38-abi3-manylinux_2_28_x86_64.whl:
Publisher:
release.yml on srimon12/qql-rs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyqql-0.1.5-cp38-abi3-manylinux_2_28_x86_64.whl -
Subject digest:
b279ec576053f55f24a2323f1f705ea65e1b22bbb09e23425446432602e0787b - Sigstore transparency entry: 2291622915
- Sigstore integration time:
-
Permalink:
srimon12/qql-rs@815128143b9b6364d52ee8af40137837fff0472f -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/srimon12
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@815128143b9b6364d52ee8af40137837fff0472f -
Trigger Event:
push
-
Statement type:
File details
Details for the file pyqql-0.1.5-cp38-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: pyqql-0.1.5-cp38-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 3.0 MB
- Tags: CPython 3.8+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6700a8d26c2c06a83848d5e1d925712ed43c6bf5a98684222ecbe9bccf549871
|
|
| MD5 |
27758bc39e4537c0aa644b8e9445eecc
|
|
| BLAKE2b-256 |
7c8cce33ef52be5c1171035b5341fdef4cb678713e3d24a72243372ec4648389
|
Provenance
The following attestation bundles were made for pyqql-0.1.5-cp38-abi3-macosx_11_0_arm64.whl:
Publisher:
release.yml on srimon12/qql-rs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyqql-0.1.5-cp38-abi3-macosx_11_0_arm64.whl -
Subject digest:
6700a8d26c2c06a83848d5e1d925712ed43c6bf5a98684222ecbe9bccf549871 - Sigstore transparency entry: 2291622898
- Sigstore integration time:
-
Permalink:
srimon12/qql-rs@815128143b9b6364d52ee8af40137837fff0472f -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/srimon12
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@815128143b9b6364d52ee8af40137837fff0472f -
Trigger Event:
push
-
Statement type:
File details
Details for the file pyqql-0.1.5-cp38-abi3-macosx_10_12_x86_64.whl.
File metadata
- Download URL: pyqql-0.1.5-cp38-abi3-macosx_10_12_x86_64.whl
- Upload date:
- Size: 3.1 MB
- Tags: CPython 3.8+, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
804c8a6d576ad8b66cb065d57b09211fd5dff455cb4b99ca8d0a0d4909131cfb
|
|
| MD5 |
bd3c9607affbb58f5ad2a5fb2ee53a22
|
|
| BLAKE2b-256 |
297cdd1266d979817f90d94df24abb82706a6c1a48e6b64759cca9244c21d720
|
Provenance
The following attestation bundles were made for pyqql-0.1.5-cp38-abi3-macosx_10_12_x86_64.whl:
Publisher:
release.yml on srimon12/qql-rs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyqql-0.1.5-cp38-abi3-macosx_10_12_x86_64.whl -
Subject digest:
804c8a6d576ad8b66cb065d57b09211fd5dff455cb4b99ca8d0a0d4909131cfb - Sigstore transparency entry: 2291622907
- Sigstore integration time:
-
Permalink:
srimon12/qql-rs@815128143b9b6364d52ee8af40137837fff0472f -
Branch / Tag:
refs/tags/v0.1.5 - Owner: https://github.com/srimon12
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@815128143b9b6364d52ee8af40137837fff0472f -
Trigger Event:
push
-
Statement type:
