nodusdb
An embedded relationship graph engine for Python. It runs inside your process: a native library holds the graph in memory, so there is no server to run and no Java to install.
- A graph with fast edge inserts and deletes, k-hop traversal and set intersection.
- Durability with a write-ahead log and snapshots.
- Typed relationship tuples, schemas and permission checks, including checks through nested groups.
- A signed log shipped to object storage, with followers, restore and takeover.
- Erasure, change watching and time travel (
as_of). - A lakehouse write path that batches upserts and deletes into Parquet.
Install
pip install nodusdb
The wheel carries its own native library. It needs Python 3.10 or newer and one of:
| Platform | Requirement |
|---|---|
| Linux x86_64 or arm64 | glibc 2.34 or newer (Ubuntu 22.04 and later, Debian 12, RHEL 9) |
| macOS x86_64 or arm64 | macOS 11 or newer |
| Windows x86_64 | none |
Alpine (musl) and older Linux distributions are not supported yet; pip reports "no matching distribution" there.
A first graph
import nodusdb
with nodusdb.Graph() as g:
g.add_edges_from([(1, 2), (2, 3), (3, 4), (1, 5), (5, 4)])
print("Reachable nodes:", g.khop(start=1, max_depth=3))
print("Common neighbors:", g.common_neighbors(3, 5))
Reachable nodes: [2, 5, 3, 4]
Common neighbors: [4]
nodusdb.__version__ reports the installed version.
Status
This is a beta release. One writer and many readers share a graph, and calls on one handle run one at a time. The README covers each feature, the limits and the compatibility promise for 0.1.x. Changes are listed in the changelog.
License
Apache License 2.0. The native library is compiled with GraalVM Community Edition Native Image; its runtime
license is in the licenses folder of the installed distribution, as described in NOTICE.
1 maintainer
Metadata
1 maintainer
Release files for nodusdb 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| nodusdb-0.1.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| nodusdb-0.1.0-py3-none-manylinux_2_34_x86_64.whl | Python 3 | none | Linux glibc 2.34+ x86-64 | Details |
| nodusdb-0.1.0-py3-none-manylinux_2_34_aarch64.whl | Python 3 | none | Linux glibc 2.34+ ARM64 | Details |
| nodusdb-0.1.0-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details |
| nodusdb-0.1.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 66.9 MB
Release files / nodusdb-0.1.0-py3-none-win_amd64.whl
| Download URL | nodusdb-0.1.0-py3-none-win_amd64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8f0bfcbca870df953e39657ddf02160d4eac652df5dee8f48fac06c5cbdc51ba
|
|
BLAKE2b-256 checksum How to use checksums |
c563fdde141a5ca5041212ad2af0d63dcaee3d39ae209f439eedb9c1fbc32228
|
| 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 20, 2026.
Transparency logRelease files / nodusdb-0.1.0-py3-none-manylinux_2_34_x86_64.whl
| Download URL | nodusdb-0.1.0-py3-none-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 13.5 MB |
| Tags | Linux glibc 2.34+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
7b8508b1bb4bef6da9e25c5b0a6e647025f85daddf95448bd31aedeaaf3033e0
|
|
BLAKE2b-256 checksum How to use checksums |
d03d4b049129c5cf80515a3bf831877a106258c3893943d5951b51f0d811e022
|
| 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 20, 2026.
Transparency logRelease files / nodusdb-0.1.0-py3-none-manylinux_2_34_aarch64.whl
| Download URL | nodusdb-0.1.0-py3-none-manylinux_2_34_aarch64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | Linux glibc 2.34+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
ed400095626f3d58fcbb973a02f25cb75163de596da356eb302c3ca4aff40108
|
|
BLAKE2b-256 checksum How to use checksums |
9fa71a4f5c4890166c869cd9f365f24e1956793f179fa8005802acf6427dd17a
|
| 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 20, 2026.
Transparency logRelease files / nodusdb-0.1.0-py3-none-macosx_11_0_x86_64.whl
| Download URL | nodusdb-0.1.0-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 13.3 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
8d369cb31a97a059cc1b876b64fc052703809496c24552c6728f75570871a199
|
|
BLAKE2b-256 checksum How to use checksums |
84f5d01ab1fa80c1ee5dbd2a213484d7d8d5d77ccc7988648aa2948355f84b8f
|
| 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 20, 2026.
Transparency logRelease files / nodusdb-0.1.0-py3-none-macosx_11_0_arm64.whl
| Download URL | nodusdb-0.1.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 13.3 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3945254d3f9a892c36d47bafe7e72d8e694eada14bcc4c278ff1da80427e30d0
|
|
BLAKE2b-256 checksum How to use checksums |
ddc2f6febc4edf3138dd41715ce4c9f57151b506c1e74133917b94791919184e
|
| 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 20, 2026.
Transparency logSecurity for nodusdb 0.1.0
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 5 files in this release have been uploaded with provenance metadata.
Attestation for nodusdb-0.1.0-py3-none-win_amd64.whl
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 20, 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.
