pyarrowspace
Python bindings for arrowspace-rs.
arrowspace is a graph-based analytics library for vector spaces, supported by a graph representation and a key-value store. The main use-cases targeted are: AI search capabilities as advanced vector similarity, graph characterisation analysis and search, indexing of high-dimensional vectors. Design principles described in this article.
For labs and tests please see tests/
Installation
Core library
The core library ships as a compiled Rust extension. It only requires numpy, pyarrow, pandas, and scikit-learn:
pip install arrowspace
Optional extras
Additional capabilities are available as optional extras:
| Extra | Packages included | Use case |
|---|---|---|
embeddings |
datasets, sentence-transformers, transformers[torch]<5.0, tsdae |
Generating embeddings from text via HuggingFace models; required for test_1_quora_questions.py and all tests above |
benchmarks |
beir, nltk |
Running BEIR/MS-MARCO benchmark suites and NLP preprocessing |
viz |
matplotlib, seaborn, tqdm |
Plotting results and progress bars in test scripts |
full |
all of the above | Full development and research environment |
Install with one or more extras:
# Required to run test_1_quora_questions.py and above
pip install arrowspace[embeddings]
# Benchmarking + visualisation
pip install arrowspace[benchmarks,viz]
# Everything (for running the full test suite)
pip install arrowspace[full]
Note:
tests/test_0_*.pyonly require the core install. All tests numberedtest_1and above require at minimumarrowspace[embeddings].
Build from source
If you have Cargo installed, you can compile and install locally using maturin:
pip install maturin[patchelf]
# quick development build
maturin develop
# optimised release build (recommended for large datasets)
maturin develop --release
Tests
test_0_*.py scripts only require the core install:
python tests/test_0_0.py
test_1 and above require the embeddings extra (pip install arrowspace[embeddings]):
python tests/test_1_quora_questions.py
Higher-numbered tests (test_3 and above) additionally require benchmarks and viz:
pip install arrowspace[full]
python tests/test_3_beir.py
Some tests require downloading a dataset separately or fine-tuning embeddings on a given dataset.
Simplest Example
from arrowspace import ArrowSpaceBuilder
import numpy as np
items: np.array = np.array(
[[0.1, 0.2, 0.3], [0.0, 0.5, 0.1], [0.9, 0.1, 0.0]],
dtype = np.float64
)
graph_params: dict = {
"eps": 1.0,
"k": 6,
"topk": 3,
"p": 2.0,
"sigma": 1.0,
}
# Create an ArrowSpace instance, returning the computed
# signal graph and lambdas
aspace, gl = ArrowSpaceBuilder().build(graph_params, items)
# Search comparable items
# defaults: k = nitems, alpha = 0.9, beta = 0.1
query: np.array = np.array(
[0.05, 0.2, 0.25],
dtype = np.float64
)
tau: float = 1.0
hits: list = aspace.search(query, gl, tau)
# Search returns a list of `(index, score`) tuples, where
# expected value from the code above show the first index
# having the top score, i.e., being nearest.
print(hits)
# [ (0, 0.989743318610787), (1, 0.7565344158360029), (2, 0.22151940739207396) ]
2 maintainers
Metadata
2 maintainers
Release files for arrowspace 0.29.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| arrowspace-0.29.0.tar.gz | 18.7 MB | Details |
Built distributions (wheels)
Total release size: 80.6 MB
Release files / arrowspace-0.29.0.tar.gz
| Download URL | arrowspace-0.29.0.tar.gz |
|---|---|
| Size | 18.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
24a670c4bffe9c00b69f07247abb15072ed1fa69c92086fae2c4773c58e8d630
|
|
BLAKE2b-256 checksum How to use checksums |
69a1fdd2499252a9f5dce0fd44401580b69d31811122364289f66b865aafb95c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
8f6876cc29d71edaf2f9241da6912e4ffbb7a31e39a5effd7abf8d52050631a3
|
|
BLAKE2b-256 checksum How to use checksums |
f59e135d22b9c1c34db753690dcc991b43112b8cda8a8146a9c49aa9fb516cdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
a1072cf3ec0cbfca0e118dda374d633d5d6de7209c290214908a51cde785e1f5
|
|
BLAKE2b-256 checksum How to use checksums |
1e586502ba3e323395ff4cb0c39f8b7917293b124bc6cff80cd447b0ddce8f0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314-win_amd64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f9424a7d747f3c3717f7ac1c541e42c3d192bcf7a196d45092ba1b4df70b15a0
|
|
BLAKE2b-256 checksum How to use checksums |
70bc665dc675931c16d89a893f608010a3547859fbf70caa0bb6fe71fc02d300
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
e642d6702444cb0147049c40a6e265242f1f23d2e464038450a106da5c972d59
|
|
BLAKE2b-256 checksum How to use checksums |
ea6ead484225cded2e3dde5de216018e5da978bf78e0913541d154a029d01f26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
d8e7aafd2f855c5ed3f90f1fcc099de0e5e2795b46d0f76ac475753fd77d1008
|
|
BLAKE2b-256 checksum How to use checksums |
bcd001bfbd16c02acffd1b0cd400e02f69b9bb94378ab4d877677e7b79827b30
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
952f6bcd85dd72ab4bcf3addffb238f12d6a82fd68f80dbe98ca6d043c2f5934
|
|
BLAKE2b-256 checksum How to use checksums |
ae5d7158e95e17ef03475f51bb804fb55c587d9dba1aa4bab8ae11cd8bc5c209
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp314-cp314-macosx_10_12_x86_64.whl
| Download URL | arrowspace-0.29.0-cp314-cp314-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.14 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
e4387572e0e7b70a498bf001bb0afc1e1419d3ad36e071a23f1c081de10dec0c
|
|
BLAKE2b-256 checksum How to use checksums |
86afc80788fe58d9c59b3d2ad4a46df5785e5ee0148ad1762e2e172a6bb26953
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp313-cp313-win_amd64.whl
| Download URL | arrowspace-0.29.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d5c1a643c24d52d1f982ed4b963fd0537e091e1ed99e01f156c594c14b149689
|
|
BLAKE2b-256 checksum How to use checksums |
e6123bd9566cb1998abd62733bdeca0911ae755b59a6a0686d28752adf9ec5fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arrowspace-0.29.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
5e584549a0764bfe0334dbd3f1611c76d56b48159b41cd4731ebdeb7f16f8433
|
|
BLAKE2b-256 checksum How to use checksums |
66aba312c8a865d4f58858e4b8773a7c4e153ba51866082999553d1305a8aa46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | arrowspace-0.29.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
466515e829070f7ed0254bea4c73e734a0876e44284234f56a830ef1800dcd27
|
|
BLAKE2b-256 checksum How to use checksums |
820aeaef8c834c92a8ede28ab7f6e481f02c100f72cdbd18bbaeea58f748f818
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | arrowspace-0.29.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4eaaae25f6b907fbef77e85c936903d9e08baf4bb513e8e33388850eb5b57236
|
|
BLAKE2b-256 checksum How to use checksums |
394478fdfea51564776d1d455d43e08e2fe3a40ac3cacb5958c25d615a83b48e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp313-cp313-macosx_10_12_x86_64.whl
| Download URL | arrowspace-0.29.0-cp313-cp313-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.13 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
ef5dd1c20801fc60eab2f5bb507134ead28f5451d862a3b73344135f3b4c06ce
|
|
BLAKE2b-256 checksum How to use checksums |
f5dd4e8f446778937402e553b88254317b29893ba1f4b8421b7008b76b3c9cb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp312-cp312-win_amd64.whl
| Download URL | arrowspace-0.29.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c48d01d48c2c7df1f2bcc82fd87cba3a9f3ce1f13ea3de3eff7a9e43bda95940
|
|
BLAKE2b-256 checksum How to use checksums |
7569bd95e90d1072662ca4f0fbab3e27f9dc393102b7055dc764012883de1202
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | arrowspace-0.29.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
4f1ba8e209638e09a9f619d98b5bcb2b7eec7796bb5af1d581ca9efd4aec163c
|
|
BLAKE2b-256 checksum How to use checksums |
ed0c65c8ab80156a092316cdb5c40248bf7dccff815a2d72790a554b3befabb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | arrowspace-0.29.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
36be04238ceb9b9e108ab0952a12c71476e2bd5ef414476e502ea621f0cba30a
|
|
BLAKE2b-256 checksum How to use checksums |
bab0736c2578143b25459926b3687277963c217150d57e7b268ff88723b81782
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | arrowspace-0.29.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e53e2a8a05b46748c40417fa5e1b59de67e6520e4e15eb76d93f6bbb8ea384dd
|
|
BLAKE2b-256 checksum How to use checksums |
b990ed4a779148c904e648e73c1e3e6cdb6a4bb2137ba6351a5d304ac530e7cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency logRelease files / arrowspace-0.29.0-cp312-cp312-macosx_10_12_x86_64.whl
| Download URL | arrowspace-0.29.0-cp312-cp312-macosx_10_12_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.12 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
724bf600afdc0be123913030a51ea64e953cc491ca53d23b0f2f7b48ccaf63ac
|
|
BLAKE2b-256 checksum How to use checksums |
81d606a5321d6d139905beeae481d25a9e4b3c1c34cfebcb46851d130078650b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 12, 2026.
Transparency log
