pyqql-edge

Local QQL for Python: qdrant-edge + FastEmbed, zero remote Qdrant.

Proposition

Same QQL language as pyqql, but storage and (optionally) embeddings run in-process (qdrant-edge 0.8). Ideal for demos, CI, air-gapped tools. Cluster-only features (GROUP BY, custom SHARD, ACORN, SHOW QUOTAS / SET QUOTA, …) fail with stable QQL-EDGE-UNSUPPORTED-* codes. Sparse PARAMS (idf = …) is supported offline.

Install

pip install pyqql-edge

Python 3.8+. Wheels: Linux x64, macOS arm64, Windows x64 (not macOS Intel — ONNX).

Quick start

import pyqql_edge

client = pyqql_edge.local_executor(
    "./qdrant_data",
    on_disk_payload=False,
    model="bge-small-en-v1.5",
)

client.execute("CREATE COLLECTION docs HYBRID")
client.execute(
    'UPSERT INTO docs VALUES {id: 1, text: "hello from edge"}'
)
report = client.execute("QUERY TEXT 'hello' FROM docs USING dense LIMIT 10")
print(report)

stmt = pyqql_edge.parse("QUERY TEXT 'hello' FROM docs USING dense LIMIT 10")[0]
pyqql_edge.inject_filter(stmt, "org_id", "=", "acme")
# Edge has no custom SHARD routing — use remote Qdrant for SHARD / CREATE SHARD KEY

client.close()

API

Export	Role
`local_executor(data_dir, …)`	FastEmbed + edge storage
`http_executor(data_dir, url, …)`	Edge storage + remote HTTP embedder
`list_embedding_models()`	Dense ONNX catalog
`parse` / `parse_json` / `is_valid` / `tokenize`	Frontend
`inject_filter`	Isolation
`Stmt.shard_key`	Property exists for AST parity; edge rejects SHARD at execute
`bind(query, params)`	Substitute `:name` (dict) or `?` (list)
`compile_query` / `explain` / `execute`	Plan / run (`params=` same as `bind`)

Edge gotchas

Topic	Reality
Point IDs	Integers or UUIDs only
HYBRID queries	Specify `USING dense` / `USING sparse` / hybrid forms
`GROUP BY`, `SHARD`, ACORN, quotas	Unsupported offline — use remote Qdrant (`QQL-EDGE-UNSUPPORTED-*`)
Sparse `idf`	Supported (qdrant-edge 0.8)
Models	Locked at executor construction
Lifetime	Call `close()` before deleting `data_dir`

Docs

qql-edge · Gaps · Syntax

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.3.1-cp310-abi3-win_amd64.whl (22.0 MB view details)

Uploaded Sep 5, 2026 CPython 3.10+Windows x86-64

pyqql_edge-0.3.1-cp310-abi3-manylinux_2_28_x86_64.whl (23.8 MB view details)

Uploaded Sep 5, 2026 CPython 3.10+manylinux: glibc 2.28+ x86-64

pyqql_edge-0.3.1-cp310-abi3-macosx_11_0_arm64.whl (20.3 MB view details)

Uploaded Sep 5, 2026 CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file pyqql_edge-0.3.1-cp310-abi3-win_amd64.whl.

File metadata

Download URL: pyqql_edge-0.3.1-cp310-abi3-win_amd64.whl
Upload date: Sep 5, 2026
Size: 22.0 MB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.3.1-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`6fae5cec99baa50584870480c62c02d613dc0d561ea325741ee42cc76159914a`
MD5	`b59774eb4be4c5ca4fc8b19d1debccc8`
BLAKE2b-256	`050e2c4ee6649798adcfe048161e09065800db3a4026cb57c6bcb890cfaa40ba`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.3.1-cp310-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.3.1-cp310-abi3-win_amd64.whl
- Subject digest: 6fae5cec99baa50584870480c62c02d613dc0d561ea325741ee42cc76159914a
- Sigstore transparency entry: 2731884441
- Sigstore integration time: Sep 5, 2026
Source repository:
- Permalink: srimon12/qql-rs@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Trigger Event: push

File details

Details for the file pyqql_edge-0.3.1-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

Download URL: pyqql_edge-0.3.1-cp310-abi3-manylinux_2_28_x86_64.whl
Upload date: Sep 5, 2026
Size: 23.8 MB
Tags: CPython 3.10+, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.3.1-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`3aab79a2ec391152c58c5b7b9c598a98d2089a537d31f66a1564a635084cd553`
MD5	`cc7ace89007d9c0afaa3ebcc10837014`
BLAKE2b-256	`9a814944201559b8cf887c991eeea9918238ce3796f110e5171f982c85446501`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.3.1-cp310-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.3.1-cp310-abi3-manylinux_2_28_x86_64.whl
- Subject digest: 3aab79a2ec391152c58c5b7b9c598a98d2089a537d31f66a1564a635084cd553
- Sigstore transparency entry: 2731884509
- Sigstore integration time: Sep 5, 2026
Source repository:
- Permalink: srimon12/qql-rs@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Trigger Event: push

File details

Details for the file pyqql_edge-0.3.1-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: pyqql_edge-0.3.1-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Sep 5, 2026
Size: 20.3 MB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyqql_edge-0.3.1-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`cb7390e859feeb7e00d2a680984ab8ebd1a91ada43bddbe5a50696b28ad684f2`
MD5	`60d6ca4e039045f1437c102870663bff`
BLAKE2b-256	`4b5a27f02d97aa85c55c794ad0da80f83d1ef24317e81fc28314b5e9d6648d3c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyqql_edge-0.3.1-cp310-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.3.1-cp310-abi3-macosx_11_0_arm64.whl
- Subject digest: cb7390e859feeb7e00d2a680984ab8ebd1a91ada43bddbe5a50696b28ad684f2
- Sigstore transparency entry: 2731884593
- Sigstore integration time: Sep 5, 2026
Source repository:
- Permalink: srimon12/qql-rs@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/srimon12
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@ba737db0114e23dd7ebba2fa1c7395f2446aa54c
- Trigger Event: push