pyqql-edge

Local QQL execution for Python — qdrant-edge + fastembed, zero network.

import pyqql_edge

# Parser (same API as pyqql)
stmt = pyqql_edge.parse("QUERY 'hello' FROM docs LIMIT 10")[0]
tokens = pyqql_edge.tokenize("QUERY 'test' FROM docs")

# Discover local ONNX models
models = pyqql_edge.list_embedding_models()
# [{'name': 'BGESmallENV15', 'model_code': 'Xenova/bge-small-en-v1.5', 'dim': 384, ...}, ...]

# Edge execution — pick model (default BGESmallENV15 / 384-d)
exec = pyqql_edge.local_executor(
    "./qdrant_data",
    on_disk_payload=False,
    model="bge-small-en-v1.5",        # enum name, HF code, or short alias
    cache_dir="/var/cache/fastembed", # optional
)

# Schema-aware text auto-embed (dense-only, sparse-only, and hybrid)
exec.execute("CREATE COLLECTION docs HYBRID")
exec.execute(
    'UPSERT INTO docs VALUES {id: "550e8400-e29b-41d4-a716-446655440001", text: "hello"}'
)
result = exec.execute("QUERY 'hello' FROM docs USING dense LIMIT 10", on_error="stop")

execute() and execute_async() return the same ExecutionReport dict as pyqql: ok, ordered results, succeeded, and failed.

Prebuilt wheels are provided for Linux x64, Windows x64, and Apple Silicon macOS. ONNX Runtime does not provide the required macOS Intel artifact, so pyqql-edge does not publish a Darwin x64 wheel.

Edge gotchas

Gotcha	Reality
Point IDs	Integers or UUIDs only — `"doc-1"` is rejected
Text UPSERT into an existing collection	Auto-embedding follows the schema: dense-only gets dense, sparse-only gets sparse, hybrid gets both
`QUERY 'text'` on HYBRID	Dense+sparse topology is ambiguous, so specify the target with `USING <vector_name>`
`GROUP BY` / shard keys	Rejected clearly; never silently ignored in edge mode
Model locked at `local_executor()`	`USING MODEL 'other'` mismatches fail
Client lifetime	Call `close()` (or use Python `with Client`) before deleting `data_dir`

Development Status
- 3 - Alpha
Programming Language
- Python :: 3
- Rust
Typing
- Typed

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

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl (20.3 MB view details)

Uploaded Jul 27, 2026 CPython 3.8+Windows x86-64

pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl (21.2 MB view details)

Uploaded Jul 27, 2026 CPython 3.8+manylinux: glibc 2.28+ x86-64

pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl (18.5 MB view details)

Uploaded Jul 27, 2026 CPython 3.8+macOS 11.0+ ARM64

File details

Details for the file pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl.

File metadata

Download URL: pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl
Upload date: Jul 27, 2026
Size: 20.3 MB
Tags: CPython 3.8+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`003fc13cb8773317edd112d2b94c06a295acbc0acfb92b3f1bf5c88cc8f25b9a`
MD5	`ded992415a89b1dc08052a59312deff2`
BLAKE2b-256	`e7e34267265897115b4aae8c9c7a77c94dbf82a4ac143f9a81ac99b289d8aa3c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl:

Publisher: release.yml on srimon12/qql-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyqql_edge-0.1.2-cp38-abi3-win_amd64.whl
- Subject digest: 003fc13cb8773317edd112d2b94c06a295acbc0acfb92b3f1bf5c88cc8f25b9a
- Sigstore transparency entry: 2262209003
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: srimon12/qql-rs@8bdbacc0fd0756367c700105d4871134d3123995
- Branch / Tag: refs/tags/v0.1.2
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@8bdbacc0fd0756367c700105d4871134d3123995
- Trigger Event: push

File details

Details for the file pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl.

File metadata

Download URL: pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl
Upload date: Jul 27, 2026
Size: 21.2 MB
Tags: CPython 3.8+, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`579880dd9c3b06e8892db2f0f3520123232ee92925ec21f1f3babfb0993b567d`
MD5	`9d0e7e494e2f9d3e6656a4f4e4e15b99`
BLAKE2b-256	`ec9dbec369c9b42bc6e25b3c471c0b842a6fc2eb0174f8940d1f79a79a9acd80`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl:

Publisher: release.yml on srimon12/qql-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyqql_edge-0.1.2-cp38-abi3-manylinux_2_28_x86_64.whl
- Subject digest: 579880dd9c3b06e8892db2f0f3520123232ee92925ec21f1f3babfb0993b567d
- Sigstore transparency entry: 2262209387
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: srimon12/qql-rs@8bdbacc0fd0756367c700105d4871134d3123995
- Branch / Tag: refs/tags/v0.1.2
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@8bdbacc0fd0756367c700105d4871134d3123995
- Trigger Event: push

File details

Details for the file pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl
Upload date: Jul 27, 2026
Size: 18.5 MB
Tags: CPython 3.8+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`bb814fe08ae201cfd58fa1ff5989479b89241978f42ee5570216134b90f73362`
MD5	`d273f831da915c58853b6d74668fd80a`
BLAKE2b-256	`665c159d4cac8778197d9d3f99d8ea8527ecb7545993bb4ccf7cb57433b70771`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on srimon12/qql-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyqql_edge-0.1.2-cp38-abi3-macosx_11_0_arm64.whl
- Subject digest: bb814fe08ae201cfd58fa1ff5989479b89241978f42ee5570216134b90f73362
- Sigstore transparency entry: 2262208578
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: srimon12/qql-rs@8bdbacc0fd0756367c700105d4871134d3123995
- Branch / Tag: refs/tags/v0.1.2
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@8bdbacc0fd0756367c700105d4871134d3123995
- Trigger Event: push