linaldb-server (Python client)
Python client for LINALDB — a SQL-inspired analytical engine treating vectors, matrices, and tensors as first-class citizens.
Status: functional through checkpoint 5 of
PYTHON_R_INTEROP_PLAN.md — /execute
and /delivery are both implemented and tested against a real server (22
passing pytest tests, plus a real end-to-end example, see below). Not
yet published to PyPI.
Talks to a running linal serve instance over its HTTP API
(POST /execute for ad-hoc DSL, /delivery/* for real Parquet dataset
export) — see ../CONTRACT.md for the exact wire
contract this client implements against. No compiled extension; requires
linal serve running an engine version >= 0.1.74 (the version that
fixed USE <database> sent to /execute to actually persist, and fixed
/delivery to honor a non-default database).
Usage
import linaldb_server as linaldb
client = linaldb.connect("http://localhost:8080")
df = client.query("SELECT id, embedding FROM docs WHERE score > 0.8")
dataset = client.dataset("my_dataset")
df = dataset.to_pandas() # requires the `pandas` extra
table = dataset.to_arrow() # pyarrow.Table, no extra required
See examples/digit_classification.py
for a complete real-data walkthrough: it starts a real linal serve,
replays a real UCI handwritten-digits classification workflow through
this client, queries the result via /execute, exports the same data via
/delivery, and independently recomputes the classification from the raw
exported vectors to confirm both paths agree exactly.
Development
pip install -e ".[dev]"
pytest
Requires cargo build --bin linal to have been run in the repo root
first — the integration tests and the example script both launch a real
linal serve from the built binary (skipped, not failed, if it's
missing).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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 linaldb_server-0.1.0.tar.gz.
File metadata
- Download URL: linaldb_server-0.1.0.tar.gz
- Upload date:
- Size: 14.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69166e89d0af3a2d711da2fcda8ed6cc70165ce620c5c47a6d225eff9997bc03
|
|
| MD5 |
e7cc5617e29adae9f3e635c70750153f
|
|
| BLAKE2b-256 |
29e48ed20ebadaebfba0100980e0b0b702dcc1c69bb1a5d5296f6872d872dae9
|
Provenance
The following attestation bundles were made for linaldb_server-0.1.0.tar.gz:
Publisher:
pypi-publish-server.yml on gorigami/linaldb
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
linaldb_server-0.1.0.tar.gz -
Subject digest:
69166e89d0af3a2d711da2fcda8ed6cc70165ce620c5c47a6d225eff9997bc03 - Sigstore transparency entry: 2773849956
- Sigstore integration time:
-
Permalink:
gorigami/linaldb@47e1f0866520f5fb69744b58a42ab8ec5e7d7ba9 -
Branch / Tag:
refs/tags/linaldb-server-v0.1.0 - Owner: https://github.com/gorigami
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish-server.yml@47e1f0866520f5fb69744b58a42ab8ec5e7d7ba9 -
Trigger Event:
push
-
Statement type:
File details
Details for the file linaldb_server-0.1.0-py3-none-any.whl.
File metadata
- Download URL: linaldb_server-0.1.0-py3-none-any.whl
- Upload date:
- Size: 8.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea6f208704b354aae2aea8fbef4798a45f74767cb7653c88846f52dbb853cc98
|
|
| MD5 |
635af843116617aa8d6fc63348d97289
|
|
| BLAKE2b-256 |
29a2b258025802a00421927eca9999b5e40776e63767184f33d5c1c3d05735c4
|
Provenance
The following attestation bundles were made for linaldb_server-0.1.0-py3-none-any.whl:
Publisher:
pypi-publish-server.yml on gorigami/linaldb
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
linaldb_server-0.1.0-py3-none-any.whl -
Subject digest:
ea6f208704b354aae2aea8fbef4798a45f74767cb7653c88846f52dbb853cc98 - Sigstore transparency entry: 2773850015
- Sigstore integration time:
-
Permalink:
gorigami/linaldb@47e1f0866520f5fb69744b58a42ab8ec5e7d7ba9 -
Branch / Tag:
refs/tags/linaldb-server-v0.1.0 - Owner: https://github.com/gorigami
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish-server.yml@47e1f0866520f5fb69744b58a42ab8ec5e7d7ba9 -
Trigger Event:
push
-
Statement type:
