This release is a pre-release and may not be stable for production use.
QaNN
QaNN (Quantized Nearest Neighbors) is a Python library for fast nearest-neighbor search, written in multithreaded, SIMD-accelerated C++ and driven from NumPy and SciPy.
- Dense vectors: exact search, IVF and HNSW graph search, product and scalar quantization, exact re-ranking.
- Sparse vectors (BM25, SPLADE): exact and approximate inverted-index search.
- Every index: custom ids, deletion, metadata filters, saving and loading.
Alpha: under active development. The API may change between releases.
Install
pip install qann
pip install scipy # only for the sparse indexes
- Wheels: Linux (x86_64, aarch64) and macOS (Apple Silicon, Intel), Python 3.10 to 3.14. x86_64 needs AVX2 and FMA.
- From source:
pip install .in a checkout. Needs CMake 3.20+, a C++20 compiler and, on Linux, optionally OpenBLAS (much faster training).
Quick start
import numpy as np, qann
x = np.random.rand(100_000, 128).astype(np.float32)
ivf = qann.IVFIndex(128, nlist=1024, nprobe=16)
ivf.enable_pq(16) # store each vector in 16 bytes
ivf.train(x, seed=1)
index = qann.RefineIndex(ivf, k_factor=10) # re-rank PQ candidates exactly
index.add(x)
ids, dists = index.batch_query(x[:5], 10) # both shaped (5, 10)
Conventions
- Vectors are 2D NumPy arrays of shape
(n, dim); single vectors (query) are(dim,). float32 C-contiguous arrays are used without copying; anything else is converted first. - Ids count up from 0 in insertion order, unless the index uses custom ids.
- Distances are smallest first: squared L2 by default, or cosine distance / negative inner product with another metric.
- Results from
batch_queryare anint64id array and afloat32distance array, both(num_queries, k). Missing hits are padded with id-1and distanceinf.
Indexes
Indexes come in two families, with one class per search algorithm:
Dense vectors (qann.DenseIndex) |
Sparse vectors (qann.SparseIndex) |
|
|---|---|---|
| Exact | FlatIndex |
InvertedIndex |
| Approximate | IVFIndex, HNSWIndex, RefineIndex (exact re-ranking of either) |
SparseApproxIndex |
- The algorithm is fixed when an index is created. Search settings such as
nprobeoref_searchare properties you can change at any time. To switch type, rebuild:new.add(old.get_vectors(old.ids()), ids=old.ids())(ids only ifnewuses custom ids). - Ids, deletion, metadata, filters and saving work the same in both families (
qann.IndexBase). qann.Indexis the old name ofqann.DenseIndexand still works.HybridIndexcombines a dense and a sparse index over the same documents; see Hybrid search.
Methods every dense index has (sparse indexes take scipy.sparse matrices instead and have no dim):
| Method | Description |
|---|---|
add(data, ids=None, *, metadata=None) |
Add an (n, dim) array, plus ids if the index uses custom ids and optional metadata. Returns the ids. |
batch_query(queries, k, *, allowed=None, where=None) |
k nearest neighbors per row, in parallel. Returns (ids, dists). See Filtered search for allowed and where. |
query(query, k, *, allowed=None, where=None) |
k nearest neighbors of one (dim,) vector. Returns 1D (ids, dists). |
remove(ids) |
Delete vectors by id. Returns how many were deleted. |
compact() |
Free the memory of deleted vectors. Returns how many were freed. |
size(), dim() |
Number of (non-deleted) vectors; vector dimension. |
ids() |
Every live id, ascending (sparse indexes too). |
get_vectors(ids) |
Copies of the stored vectors, (n, dim), in the order given. Not on PQ or SQ indexes, which keep only codes (stores_vectors is False); a RefineIndex over them works. With Cosine they come back unit-length. |
save(path) |
Save to a file; see Saving and loading. |
metadata_schema, get_metadata, update_metadata, add_metadata_column, drop_metadata_column |
See Metadata. |
Which to pick: FlatIndex up to a few hundred thousand vectors; IVF + fast-scan + RefineIndex when you can train on representative data and build time matters; HNSW when you can't train up front or new kinds of vectors keep arriving. Benchmark on your own data; measurements.
FlatIndex(dim, *, custom_ids=False)
Exact brute-force search: no training, 100% recall, cost linear in the number of vectors. Also useful as ground truth when measuring recall.
index = qann.FlatIndex(128)
index.add(x)
ids, dists = index.batch_query(x[:10], 10)
IVFIndex(dim, nlist, nprobe=10, *, custom_ids=False)
Clusters vectors into nlist lists with k-means, and scans only the nprobe lists nearest each query.
| Member | Description |
|---|---|
train(data, max_iters=25, seed=None) |
Learn the centroids from at least nlist vectors. Call once, before add. |
enable_pq(num_subspaces, centroids_per_subspace=None, *, fast_scan=False, rotate=False) |
Compress vectors with product quantization. Call before train. |
enable_sq(bits=8) |
Store 8 or 4 bits per dimension instead of floats (SQ). Call before train; not with PQ. |
nprobe |
Lists scanned per query: higher is slower and more accurate. |
pq_distance |
qann.PQDistance.ADC (default, more accurate) or SDC. |
precomputed_tables |
Lookup tables built at train time that speed up PQ queries. On by default; False frees them. |
fast_scan, sq_bits |
Read-only: the compression in use. |
nlistmust be 100 to 65535. Start withnlistaroundsqrt(n)to4 * sqrt(n), andnprobeat 1% to 5% ofnlist.- With PQ, each vector is split into
num_subspacesslices stored as one byte each: a 128-dim vector (512 bytes) with 16 subspaces takes 16 bytes.dimmust divide evenly. Distances become approximate; wrap the index in aRefineIndexto recover recall.
ivf = qann.IVFIndex(128, nlist=1024, nprobe=16)
ivf.enable_pq(16)
ivf.train(x, seed=1)
ivf.add(x)
ivf.nprobe = 32 # trade speed for recall
Fast-scan
enable_pq(num_subspaces, fast_scan=True) stores 4 bits per slice and scores 32 vectors per SIMD lookup, about 6x faster than regular PQ. Use twice the subspaces you would with regular PQ, and pair it with a RefineIndex:
ivf = qann.IVFIndex(128, nlist=1024, nprobe=16)
ivf.enable_pq(64, fast_scan=True) # 64 x 4 bits = 32 bytes per vector
ivf.train(x, seed=1)
refine = qann.RefineIndex(ivf, k_factor=16)
refine.add(x)
num_subspacesmust be even and at most 1024.pq_distancemust stayADC.- Without a
RefineIndex, recall is lower and distances are approximate.
Rotation
enable_pq(..., rotate=True) also learns a rotation that spreads information evenly over the subspaces. It helps when dimensions are correlated (SIFT: noticeably higher recall before re-ranking) and does nothing when they aren't (GloVe). Results stay valid either way. Measure on your data.
SQ
enable_sq(8) stores one byte per dimension (a quarter of the floats' memory) and enable_sq(4) half a byte. 8 bits loses little recall and needs no RefineIndex; 4 bits should be wrapped in RefineIndex(k_factor=8).
ivf = qann.IVFIndex(128, nlist=1024, nprobe=16)
ivf.enable_sq(8)
ivf.train(x, seed=1)
ivf.add(x)
Fast-scan, rotation and SQ measurements.
HNSWIndex(dim, M=16, ef_construction=200, *, custom_ids=False, seed=None)
A graph index: each vector links to M near neighbors, and a query walks the graph toward its target. No training, exact distances, builds on all cores; it uses more memory per vector and adds more slowly than IVF.
| Member | Description |
|---|---|
ef_search |
Candidates kept while searching (default 64): higher is slower and more accurate. |
M, ef_construction |
Read-only: the build settings. Higher builds a better graph, more slowly. |
enable_sq(bits=8), train(x) |
Store 8- or 4-bit codes instead of floats. Call enable_sq, then train on a representative sample, before add. |
sq_bits |
Read-only: 8 or 4 with SQ, else 0. |
index = qann.HNSWIndex(128, M=16, ef_construction=200)
index.add(x)
index.ef_search = 128 # trade speed for recall
ids, dists = index.batch_query(q, 10)
M: 16 suits data like SIFT. For text embeddings useM=32to48withef_construction=300to400.- Deleting hides vectors from results.
compact()rebuilds the graph, so call it after many deletes, not each one. - Reproducible builds need
seedandqann.set_num_threads(1); parallel builds differ slightly run to run. - SQ: wrap in a
RefineIndex.k_factor=2is enough for 8 bits; 4 bits needs 4 to 8.
index = qann.HNSWIndex(128)
index.enable_sq(8)
index.train(x)
refine = qann.RefineIndex(index, k_factor=2)
refine.add(x)
RefineIndex(base, k_factor=10, *, custom_ids=False)
Fetches k * k_factor candidates from an approximate base, then re-ranks them by exact distance using full copies of the vectors. This is the usual way to get PQ or SQ speed with near-exact ranking.
basemust be trained, empty, without custom ids and never compacted. Give theRefineIndexits owncustom_idsinstead.- Add, remove and compact through the
RefineIndex. Doing it on the base raisesValueError. - Tune the base through the
baseproperty, e.g.refine.base.nprobe = 32.k_factorcan change at any time.
InvertedIndex(*, custom_ids=False)
Exact search over sparse vectors: BM25 weights or learned sparse vectors such as SPLADE, as scipy.sparse matrices (a column is a term id). Scores by dot product: distance is -(q . d), largest dot product first.
import scipy.sparse as sp
index = qann.InvertedIndex()
index.add(doc_matrix, metadata={"lang": langs}) # (n_docs, vocab) CSR
ids, dists = index.batch_query(query_matrix, 10, where="lang = 'en'")
ids, dists = index.query(query_matrix[[0]], 10) # one row
- Input: any
scipy.sparsematrix or array; term ids below 2^32. Duplicate entries in a row are summed, zeros dropped. - Results: only documents sharing a term with the query come back, so a row can have fewer than
k. - Pruning (
pruning, on by default) skips work that can't change the topk. Results are identical either way; it helps most at smallk. - Size:
termsandpostingscount distinct terms and stored entries (8 bytes each).
SparseApproxIndex(*, custom_ids=False, query_terms=10, list_depth=10000, k_factor=10)
Approximate sparse search for queries with many terms, such as SPLADE's. Same input and features as InvertedIndex, about twice its memory.
index = qann.SparseApproxIndex()
index.add(doc_matrix)
ids, dists = index.batch_query(query_matrix, 10)
index.list_depth = 2000 # faster, lower recall
- A query uses its
query_termslargest values, reads thelist_depthheaviest entries of those terms, and re-scores the bestk * k_factorexactly.0means all. - Returned distances are exact; only which documents are found is approximate.
- The defaults reached 0.96 recall@10 at about 14x the speed of exact search on 1M SPLADE passages. Measurements.
make_index(type, dim, opts=IndexOptions())
Builds any index from a type and an options object:
opts = qann.IndexOptions()
opts.nlist, opts.nprobe, opts.pq_subspaces = 1024, 16, 16
ivf = qann.make_index(qann.IndexType.IVF, 128, opts)
IndexType is Flat, IVF, HNSW, Inverted or SparseApprox (sparse types ignore dim; pass 0). IndexOptions fields and defaults:
| For | Fields |
|---|---|
| all | custom_ids (False), metric (L2, dense only) |
| Flat | capacity (1024) |
| IVF | nlist (100), nprobe (10), pq_subspaces (0 = no PQ), pq_centroids (256), ivf_sq_bits (0) |
| HNSW | hnsw_m (16), ef_construction (200), ef_search (64), hnsw_sq_bits (0) |
| Inverted | pruning (True) |
| SparseApprox | query_terms (10), list_depth (10000), k_factor (10) |
Metrics
Dense indexes take metric=qann.Metric.L2 (default), Cosine or InnerProduct, fixed at construction, saved with the index and reported by index.metric. They work with every dense index and compression.
index = qann.HNSWIndex(384, metric=qann.Metric.Cosine)
index.add(embeddings)
ids, dists = index.batch_query(query_embeddings, 10) # dists = 1 - cosine similarity
- Cosine suits most text and image embeddings. Distance is
1 - cosine similarity(0 to 2). Vectors are normalized for you; a zero vector raisesValueError.
Inner product
Use InnerProduct when vector length matters: recommendation factors, multi-vector retrieval (ColBERT, MUVERA), models trained with a dot-product loss.
index = qann.HNSWIndex(64, metric=qann.Metric.InnerProduct)
index.add(item_factors)
ids, dists = index.batch_query(user_factors, 10) # dists = -(q . x)
- Distance is
-(q . x), so results stay smallest first. Nothing is normalized. - PQ must use
ADC, andprecomputed_tablesreadsFalse(not needed). - HNSW links its graph with a transform that makes inner product search work far better than linking by raw dot product. Measurements.
Custom ids and deleting
Create an index with custom_ids=True to use your own ids (database keys, document ids):
index = qann.FlatIndex(128, custom_ids=True)
index.add(vectors, ids=doc_ids) # one int per row
ids, dists = index.batch_query(queries, 10) # ids are your doc_ids
index.remove([doc_ids[0], doc_ids[1]]) # returns 2
- Ids can be any integer array, list or
range. They must be>= 0and unique; a bad batch adds nothing. Every add must pass them. removeskips unknown and already deleted ids. A deleted id can be added again.compact()frees deleted vectors' memory and keeps ids and results unchanged (HNSW rebuilds its graph, so its results can shift slightly). Call it after a large batch of deletes.- Default ids never repeat, even after deletes and
compact(). Keep the idsadd()returns, or use custom ids for data that changes.
Filtered search
To search only some vectors, pass the ids that may be returned as allowed, or filter on stored metadata with where:
in_stock = product_ids[stock > 0]
ids, dists = index.batch_query(queries, 10, allowed=in_stock)
- Filtering happens during the search, so a selective filter still returns
kresults when that many match. - Works on every index, with recall close to unfiltered search. Very narrow filters switch to scoring the allowed vectors directly, which is exact.
- Unknown and deleted ids in
allowedare ignored. One set applies to every row of abatch_query. - Tuning:
HNSWIndex.filter_ef_scalingandIVFIndex.filter_probe_scaling(both on, not saved) keep filtered recall near unfiltered. Turn them off for faster queries when filtered recall is already high on your data.
How each index filters, and measurements.
Metadata
Store attributes with each vector and filter on them:
index.add(vectors, metadata={"category": categories, "price": prices, "year": years})
f = qann.field
ids, dists = index.batch_query(queries, 10, where=(f("category") == "shoes") & (f("price") < 50))
ids, dists = index.batch_query(queries, 10, where=f("year").isin([2024, 2025]) | f("price").is_null())
# or as a SQL WHERE clause, with values passed separately
ids, dists = index.batch_query(queries, 10, where="category = 'shoes' AND price < 50")
ids, dists = index.batch_query(queries, 10, where=("user_id = ? AND year IN (?, ?)", [uid, 2024, 2025]))
- Columns hold ints, floats or strings, one value per vector.
Noneis a null, and so is any column an add leaves out. - Nulls fail every comparison. Use
f("price").is_null()to select them. SQL'sNOTexcludes nulls;~includes them. qann.fieldoperators:==,!=,<,<=,>,>=,.isin([...]),.between(lo, hi),.is_null(), combined with&,|,~.- Parenthesize comparisons:
(f("a") < 1) & (f("b") == 2). - Python's
and/or/notraiseTypeError. - For long chains use
qann.any_of(...)/qann.all_of(...).
- Parenthesize comparisons:
- SQL: comparisons,
[NOT] IN,IS [NOT] NULL,[NOT] BETWEEN,AND,OR,NOTand parentheses. Bad syntax raisesValueError. - Parameters: pass values as
(sql, [values])for?or(sql, {name: value})for:name, never pasted into the string.qann.where(sql, params)returns a reusable filter. - Combining: with both
whereandallowed, results must pass both.
Reading and changing metadata:
| Call | Does |
|---|---|
get_metadata(ids, columns=None) |
{name: values}, one value per id. Numbers come back as NumPy masked arrays (masked = null), strings as lists with None. |
update_metadata(ids, {"price": [10, None]}) |
Overwrites those columns for those vectors in place. |
add_metadata_column(name, type, *, default=None, ids=None, values=None) |
New column ('int', 'float' or 'str'): all default, or values for ids and null elsewhere. |
drop_metadata_column(name) |
Removes a column. |
metadata_schema |
Each column's name and type. |
Unknown, deleted or repeated ids raise ValueError. Metadata stays with its vector through remove, compact, save and load. Types, SQL limits and costs.
Hybrid search
Dense and sparse retrievers miss different things: embeddings find paraphrases, keyword weights (BM25, SPLADE) find exact rare terms. A HybridIndex holds both representations of every document, searches both and fuses the rankings:
dense = qann.HNSWIndex(384, metric=qann.Metric.Cosine)
sparse = qann.InvertedIndex()
hybrid = qann.HybridIndex(dense, sparse, custom_ids=True)
hybrid.add(embeddings, bm25_matrix, ids=doc_ids) # row i of each is document doc_ids[i]
ids, scores = hybrid.batch_query(q_embeddings, q_bm25, 10, where="lang = 'en'") # highest score first
- One index, one set of ids. The
HybridIndexkeeps the ids and metadata, and both parts stay aligned because only it changes them.addchecks both representations first, so a bad row adds nothing anywhere.remove,compact,saveandqann.loadcover both parts. - Parts: any empty dense index (trained, if it needs it; a
RefineIndexworks too) and any empty sparse index, neither with custom ids. Tune them throughhybrid.denseandhybrid.sparse(e.g.hybrid.dense.ef_search = 128). Adding to them directly raisesValueError. - Fusion settings, saved with the index:
method:"linear"(default) or"rrf", as inqann.fusebelow.weights:(dense, sparse), default(1, 1).rrf_k: default 60.depth_factor: each side fetchesk * depth_factorresults before fusing, default 5.
- Results are
(ids, scores): fusion scores, higher is better, padded with-1/0.querytakes one(dim,)vector and a one-row sparse matrix. - Measured on BEIR, the default (linear, equal weights) beat RRF on every dataset and model tried, and beat the better single retriever in most; tuned weights added up to +0.05 nDCG@10. Results.
Tuning the weights. The best (dense, sparse) weights depend on your data and models: when one side is much weaker, give it less weight. With a few dozen queries whose relevant documents you know, try a few settings and keep the best:
def hit_rate(hybrid, q_dense, q_sparse, relevant, k=10): # relevant: one set of doc ids per query
ids, _ = hybrid.batch_query(q_dense, q_sparse, k)
return np.mean([len(set(row) & rel) > 0 for row, rel in zip(ids, relevant)])
scores = {}
for w in [(1, 0.25), (1, 0.5), (1, 1), (0.5, 1)]:
hybrid.weights = w
scores[w] = hit_rate(hybrid, q_dense, q_sparse, relevant)
hybrid.weights = max(scores, key=scores.get) # saved with the index
Any ranking metric works (hit rate, recall, nDCG); hold back some labeled queries to check the choice. benchmarks/hybrid_beir.py does this on BEIR.
Fusing results yourself: qann.fuse(results, *, method="rrf", k=60, weights=None, limit=10) merges any ranked lists, for example several dense models or results from another search engine:
d = dense_a.batch_query(q_a, 50) # fetch several times what you need
s = dense_b.batch_query(q_b, 50)
ids, scores = qann.fuse([d, s], limit=10)
"rrf"(reciprocal rank fusion, the default): each id scoresweight / (k + rank)in every list that has it. Only ranks count, so scores on different scales never need comparing: the safe choice."linear": each list's distances are rescaled per query to 1 (nearest) down to 0 (farthest returned), then summed withweights. With weights tuned on a few labeled queries it usually beats"rrf".- Inputs are
queryorbatch_queryresults, all 1D or all 2D ("rrf"also takes plain id arrays). Ids must mean the same document in every list.
Saving and loading
index.save("vectors.qann") # str or pathlib.Path
index = qann.load("vectors.qann") # returns the saved class, e.g. IVFIndex or InvertedIndex
- Everything is restored: vectors, ids, deletions, training, graphs, metadata, the metric and settings. A loaded index gives identical results and keeps accepting adds.
- A
RefineIndexfile includes its base. Tune it throughloaded.base. - Larger than RAM:
qann.load(path, mmap=True)leaves aRefineIndex's raw vectors, anIVFIndex's float and SQ lists and a sparse index's posting lists in the file and reads only what queries touch, so memory holds just the centroids, any PQ codes, ids and metadata. Results are identical; keep the file in place while the index is open. Details. - Safe: an interrupted save never leaves a partial file, and a corrupt or foreign file raises
RuntimeError. - Versioned: newer releases load files from older ones. Details.
PQCodebook on its own can't be saved yet; save the IVFIndex that uses it.
Product quantization
PQCodebook(dim, num_subspaces, centroids_per_subspace=256) is the quantizer inside IVFIndex, for direct use:
| Method | Description |
|---|---|
train(data, max_iters=25, seed=None) |
k-means in each subspace over an (n, dim) array. |
encode(vec) |
A (dim,) vector to num_subspaces uint8 codes. |
compute_adc_table(query) |
Distances from a (dim,) query to every centroid, reusable across codes. |
distance_adc(table, code) |
Approximate squared L2 between the table's query and a code. |
distance_sdc(query_code, code) |
Approximate squared L2 between two codes. |
dim(), num_subspaces(), centroids_per_subspace() |
Shape of the codebook. |
pq = qann.PQCodebook(128, 16)
pq.train(x, seed=1)
codes = [pq.encode(v) for v in x[:1000]]
table = pq.compute_adc_table(x[0])
dists = [pq.distance_adc(table, c) for c in codes]
Utilities
| Function | Description |
|---|---|
l2_distance(a, b) |
Row-wise squared L2 between two (m, dim) arrays. |
cosine_distance(a, b) |
Row-wise cosine distance between two (m, dim) arrays. |
set_num_threads(n) |
Threads for batch queries, adds and training. 0 (default) uses every core. |
num_threads() |
Thread count in effect. |
fuse(results, *, method="rrf", k=60, weights=None, limit=10) |
Merge ranked results from several retrievers; see Hybrid search. |
__version__ |
Installed version. |
Threads and type hints
- Thread-safe: queries, adds and training release the GIL, and several threads can query one index at once. Adds and setting changes wait for running queries, so no query sees a half-updated index.
- Typed: wheels include type stubs for editors and type checkers.
More
ARCHITECTURE.md has the design, a file-by-file reference, the measurements behind this README and the benchmarks.
Metadata
Release files for qann 0.1.0a26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qann-0.1.0a26.tar.gz | 3.8 MB | With provenance | Details for qann-0.1.0a26.tar.gz |
Built distributions (wheels)
Total release size: 99.3 MB
Release files / qann-0.1.0a26.tar.gz
| Download URL | qann-0.1.0a26.tar.gz |
|---|---|
| Size | 3.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
78bc1f955d4bc66035d208d9469a694ff05ea48942759f7f0b13abf76cdadec9
|
|
BLAKE2b-256 checksum How to use checksums |
21d82516fba46fd6922ce34f53e9b39bb992d7d8cdd098a7facc64a5286402e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qann-0.1.0a26-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 12.6 MB |
| Tags | CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
73da25830ffa32d3cd39ca4b6409d2f9f5155446dd48ba6df6810dce719c18d0
|
|
BLAKE2b-256 checksum How to use checksums |
b4c3684754a50be08c8b8a8269919a2ab86b893efb5ccba681d964eb0f7005e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | qann-0.1.0a26-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | CPython 3.14 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
dc3c0785655e12d4f24574e794f3251dccce301342e278d1ecdcf4d67289cfcd
|
|
BLAKE2b-256 checksum How to use checksums |
a50c694c096158e17c20ad42a95fa4907d1179bdaa9947a0ba2f580b8dac0662
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp314-cp314-macosx_11_0_x86_64.whl
| Download URL | qann-0.1.0a26-cp314-cp314-macosx_11_0_x86_64.whl |
|---|---|
| Size | 483.9 kB |
| Tags | CPython 3.14 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
19a0681acde74d0ead0f84be8404ea33d8ed75787061e21bf2f223298ed71b7a
|
|
BLAKE2b-256 checksum How to use checksums |
bc573167eef35e440ac2971f06e62373941f15833c57771578996afdb3e22a3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | qann-0.1.0a26-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 415.9 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
61a1d214dcd8d0c6f802a5620adef9faf7ea14fabb69efb4787281588bf378de
|
|
BLAKE2b-256 checksum How to use checksums |
44b4ff7ff5a4f7067f12da9e9549ebb62e3ff9914acd686f4b28ec39968ca8d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qann-0.1.0a26-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 12.6 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
18d02dbccebd0fffe193648c0e28f806f596456729a069e9ae1eb6824299586f
|
|
BLAKE2b-256 checksum How to use checksums |
2f63f247c5329319a1a2dc86ad9d54bf8243542664f90ec3ecfcd71f7bbfe78a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | qann-0.1.0a26-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
ce35826a12d372bfc03564ed9b125e0c625649d240ab3cc5ddc6402919834597
|
|
BLAKE2b-256 checksum How to use checksums |
e4ce044761179cadfaca3b28554b0c627cc19489b75d0eff010c2b51460f08b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp313-cp313-macosx_11_0_x86_64.whl
| Download URL | qann-0.1.0a26-cp313-cp313-macosx_11_0_x86_64.whl |
|---|---|
| Size | 484.0 kB |
| Tags | CPython 3.13 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
fe9bbecb163897fe741971b1660d4b2ddf0e2cbbb4bcb41a28cae13e0cf65585
|
|
BLAKE2b-256 checksum How to use checksums |
43c242e60cf0071dffea64224f19fc0a09dfebfcf08d2abb4e972e070000f445
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | qann-0.1.0a26-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 415.7 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
07dbdbeb97673793b356b6142879c989a137626ce6be55ed986f025cf049f6e4
|
|
BLAKE2b-256 checksum How to use checksums |
7b71b2a5eb6f298c0ea30e0d4afd2e07bbe1b684c7df52c685848acaadb9da0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qann-0.1.0a26-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 12.6 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
5c342c4ebf9153103e8aa6db6c6287be90a6050d21617ce626c163d0a9b3dccb
|
|
BLAKE2b-256 checksum How to use checksums |
3970cdc676f4370269c6cbf42aae8e9a807e466f1217c4ed714153b5de2e561e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | qann-0.1.0a26-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
8da689962b7c1c0afda5a1c19ad997e5feb8ee42545082c4c32bbe85b8fc54c6
|
|
BLAKE2b-256 checksum How to use checksums |
62e9158a861927b1777f3a375375ed8e7edc6c4e890495c5e7b5bead10eb7a4f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp312-cp312-macosx_11_0_x86_64.whl
| Download URL | qann-0.1.0a26-cp312-cp312-macosx_11_0_x86_64.whl |
|---|---|
| Size | 484.0 kB |
| Tags | CPython 3.12 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
3d5e5151ac288a157ec7d8a81a9e71a5687f6a428246348b57e6fa96947c2911
|
|
BLAKE2b-256 checksum How to use checksums |
86d08b4ba5b9df07f4168c62c2a7f06750d09dddf745a52059b09d4f22873ae0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | qann-0.1.0a26-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 415.7 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
46b94e8a654774681df4b61b0cbfd78b3bca0d39ffc3c7b7380bfa28ff7ac074
|
|
BLAKE2b-256 checksum How to use checksums |
549c254566a4ce495a89460bb440ce99f8ea398fdf9793dc0ee448781f868863
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qann-0.1.0a26-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 12.6 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
dc21608a770d9561b1cd9bfd5d3901d3b8d5b2ff0cd59cb4a5ecf37d83f03997
|
|
BLAKE2b-256 checksum How to use checksums |
8d282f10dca3a213f0c1c42fc7095484b84a654b476aa739cdbcc51d6516459a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | qann-0.1.0a26-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
7fdac1e9e547f6e8a29559957e39d26ebce341b3ff9f1b58f69b07bdfb734681
|
|
BLAKE2b-256 checksum How to use checksums |
5b01902997c1be4c31283339afa258752d8fbead7b56f05c969e56a0abeabdb2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp311-cp311-macosx_11_0_x86_64.whl
| Download URL | qann-0.1.0a26-cp311-cp311-macosx_11_0_x86_64.whl |
|---|---|
| Size | 484.1 kB |
| Tags | CPython 3.11 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
e6455e34c24bfd53005904c9304925e6eb4d96a16ea43434022111f18ee9a91a
|
|
BLAKE2b-256 checksum How to use checksums |
6b8a005dc8a372564563a692eabc102e130f425e29831f4d56910862c93e7b19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | qann-0.1.0a26-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 416.3 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3e93d86b16b5ca0b9b1e92eaaed52f426b1d3b3deecc1b6f2b33ae8505e4e5a4
|
|
BLAKE2b-256 checksum How to use checksums |
9e7590a48dad173aff4c7b1575a2dc9dbb9edca34cc8cc7d71321198aba80261
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qann-0.1.0a26-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 12.6 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cb4df4c35b8a32cb3f65bee12bcc69e993042933990dea43684c7e1a1a4106db
|
|
BLAKE2b-256 checksum How to use checksums |
ddd479ff8a2e7ca0efcccce3f23850f743bc0d22d682337f0c18b6a40ef01c91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
| Download URL | qann-0.1.0a26-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
93caaa28f15442b7e730c6ea1a33960303bb2a951fb525dec1747539fb951e1b
|
|
BLAKE2b-256 checksum How to use checksums |
c9f87b27cedda96495a99187a2b0653995742d5f07ec013d4752bd1561ba8787
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp310-cp310-macosx_11_0_x86_64.whl
| Download URL | qann-0.1.0a26-cp310-cp310-macosx_11_0_x86_64.whl |
|---|---|
| Size | 483.9 kB |
| Tags | CPython 3.10 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
7f198f5fdd6ae7cd60bc1838928040813bc9a22510820c74680f83b48f888348
|
|
BLAKE2b-256 checksum How to use checksums |
7d8ab29b2d0bbfa34559cfd88b32c07c74b65c0cfe12c4dd1189237284258144
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logRelease files / qann-0.1.0a26-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | qann-0.1.0a26-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 416.1 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c32e46d2f6fe4093cbc393416eac8bbb3a8ac743b50cd3cedea962fe509af8a3
|
|
BLAKE2b-256 checksum How to use checksums |
32cb31b386f08a264291467dbd14cd5dcdb0c69e173dcc59658508a63dd5d062
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logSecurity for qann 0.1.0a26
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 21 files in this release have been uploaded with provenance metadata.
Attestation for qann-0.1.0a26.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.