uni-db: Python Bindings for Uni Graph Database
Python bindings for the Uni embedded graph database.
Part of The Rustic Initiative by Dragonscale Industries Inc.
Installation
pip install uni-db
Quick Start
from uni_db import Uni
# Open or create a database (`Uni.in_memory()` for an ephemeral one)
db = Uni.open("./my_graph")
# Define schema
db.schema() \
.label("Person") \
.property("name", "string") \
.property_nullable("age", "int64") \
.index("name", "btree") \
.apply()
# Write data. `Uni` is lifecycle and admin only: reads go through a Session,
# writes through a transaction on one.
session = db.session()
tx = session.tx()
tx.execute("CREATE (p:Person {name: 'Alice', age: 30})")
tx.execute("CREATE (p:Person {name: 'Bob', age: 25})")
tx.commit()
# Query (read-only)
results = session.query(
"MATCH (p:Person) WHERE p.age > $min RETURN p.name",
{"min": 28},
)
print(results) # [{'p.name': 'Alice'}]
Schema Operations
# Labels, edge types, properties and indexes are all declared through the
# schema builder and committed together by a single `.apply()`.
db.schema() \
.label("Person") \
.property("name", "string") \
.property_nullable("age", "int64") \
.vector("embedding", 384) \
.index("name", "btree") \
.index("embedding", {"type": "vector", "metric": "cosine"}) \
.done() \
.edge_type("KNOWS", ["Person"], ["Person"]) \
.property_nullable("since", "date") \
.apply()
# Introspection
db.schema().current() # dict view of the whole schema
db.schema().current_typed() # typed `Schema` object
Transactions
tx = db.session().tx()
tx.execute("CREATE (p:Person {name: 'Charlie'})")
tx.commit() # or tx.rollback()
Bulk Loading
The bulk writer is built from a transaction.
tx = db.session().tx()
writer = tx.bulk_writer().build()
vids = writer.insert_vertices("Person", [
{"name": "Alice", "age": 30},
{"name": "Bob", "age": 25},
])
writer.insert_edges("KNOWS", [
(vids[0], vids[1], {}), # (src_vid, dst_vid, properties)
])
writer.commit()
tx.commit()
Vector Search
# Declare the vector column and its index
db.schema() \
.label("Document") \
.property("text", "string") \
.vector("embedding", 128) \
.index("embedding", {"type": "vector", "metric": "cosine"}) \
.apply()
session = db.session()
tx = session.tx()
tx.execute("CREATE (d:Document {text: 'hello world', embedding: $v})", {"v": my_embedding})
tx.commit()
db.flush()
# K-NN search. `k` is required.
results = session.query('''
CALL uni.vector.query('Document', 'embedding', $vec, 10)
YIELD node, score
RETURN node.text AS text, score
ORDER BY score DESC
''', {"vec": my_embedding})
# K-NN with pre-filter (SQL WHERE expression)
results = session.query('''
CALL uni.vector.query('Document', 'embedding', $vec, 10, 'category = "tech"')
YIELD node, score
RETURN node.text AS text, score
''', {"vec": my_embedding})
# K-NN with a similarity floor. `threshold` is a MINIMUM SIMILARITY on the
# same scale as `score` (larger is a better match), not a maximum distance.
results = session.query('''
CALL uni.vector.query('Document', 'embedding', $vec, 10, NULL, 0.8)
YIELD node, score
RETURN node.text AS text, score
''', {"vec": my_embedding})
YIELD columns: node (the matched vertex), score (similarity, larger is better) and distance (the raw metric distance).
Async API
from uni_db import AsyncUni
db = await AsyncUni.open("./my_graph")
# or: db = await AsyncUni.temporary()
session = db.session()
tx = await session.tx()
await tx.execute("CREATE (p:Person {name: 'Alice', age: 30})")
await tx.commit()
results = await session.query("MATCH (p:Person) RETURN p.name")
await db.flush()
Forks
Named, durable, isolated branches of the graph. A fork lets a session reason about an alternate version of the database — what-if analysis, audit hold, scenario sandboxing — that survives across restarts.
import uni_db
from datetime import timedelta
db = uni_db.Uni.builder().build()
db.schema().label("Person").property("name", "string").apply()
primary = db.session()
# Open or create a fork (Phase 2: writable; Phase 3: nestable;
# Phase 4a: TTL + tags + budget).
fork = primary.fork("scenario_1").ttl(timedelta(hours=1)).build()
tx = fork.tx()
tx.execute("CREATE (:Person {name: 'fork-only'})")
tx.commit()
# Fork sees primary state + its own writes; primary unchanged.
print(fork.query("MATCH (p:Person) RETURN count(p) AS n"))
# Pin a Lance tag for audit retention; the tag survives the drop.
db.tag_fork("scenario_1", "audit-2026-q1")
del fork
db.drop_fork("scenario_1")
print(db.list_fork_tags("scenario_1")) # tag still resolvable
The async surface mirrors this exactly through AsyncUni /
AsyncSession. See examples/fork_quickstart.py and
examples/fork_audit.py for runnable demos, and the full
Python API reference
for every method, type, and error variant.
Query Utilities
# Parameterized queries
results = db.query(
"MATCH (p:Person) WHERE p.name = $name RETURN p",
{"name": "Alice"},
)
# Explain / profile
plan = db.explain("MATCH (p:Person) RETURN p")
results, stats = db.profile("MATCH (p:Person) RETURN p")
Development
git clone https://github.com/rustic-ai/uni-db
cd uni-db/bindings/uni-db
uv sync --group dev
uv run maturin develop # builds and installs the extension module
uv run pytest # run tests
Links
License
Apache 2.0
Metadata
Release files for uni-db 5.2.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 | Provenance | Actions |
|---|---|---|---|---|
| uni_db-5.2.0.tar.gz | 8.4 MB | Without provenance | Details for uni_db-5.2.0.tar.gz |
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| uni_db-5.2.0-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details for uni_db-5.2.0-cp310-abi3-win_amd64.whl |
| uni_db-5.2.0-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details for uni_db-5.2.0-cp310-abi3-manylinux_2_28_x86_64.whl |
| uni_db-5.2.0-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details for uni_db-5.2.0-cp310-abi3-manylinux_2_28_aarch64.whl |
| uni_db-5.2.0-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details for uni_db-5.2.0-cp310-abi3-macosx_11_0_arm64.whl |
Total release size: 408.8 MB
Release files / uni_db-5.2.0.tar.gz
| Download URL | uni_db-5.2.0.tar.gz |
|---|---|
| Size | 8.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e6c8a91edc238c721c2411001c6a193d87ce9be32524a92095f7739961927ab6
|
|
BLAKE2b-256 checksum How to use checksums |
dd2ec53c899c740d5ef84ea4aa67a4ac3da7a45062ea97b706cfad241f5fdf17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / uni_db-5.2.0-cp310-abi3-win_amd64.whl
| Download URL | uni_db-5.2.0-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 107.3 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
db0c8ab8d2777c16df2d3bebbad340980f3944ff9c33e25d3f64a45393ae310c
|
|
BLAKE2b-256 checksum How to use checksums |
811b530ad55fea94023813d3866ae75327f3b0e4f7ad81e449c6b6c75a524bae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / uni_db-5.2.0-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | uni_db-5.2.0-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 103.2 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
abe2a73b9e2b71e8a0a7082165af5d87b89359046afa251b44e68d901a9c976c
|
|
BLAKE2b-256 checksum How to use checksums |
54db94d658d9e940efbe81a13c5170cd85ede06ae09e896b01e9cc1aaa5ff7f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / uni_db-5.2.0-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | uni_db-5.2.0-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 99.1 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
2d49f9fd2256472246854306e3f6f82771c2bfd0610b0bddd8cf37decc2b025d
|
|
BLAKE2b-256 checksum How to use checksums |
a981123b6ead75ca293408d22fd670420dd43da12c0d490e53e09dd78aaccdcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / uni_db-5.2.0-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | uni_db-5.2.0-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 90.8 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
60ed046d0dba2ae2df22ffcf6a3b1b285c63c03e267908dd80cfb214f54c9984
|
|
BLAKE2b-256 checksum How to use checksums |
e8c5c468ecd95556fef8fa42803ef51951de7a7c837d9f4a71696c86762652c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for uni-db 5.2.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A 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.