YantrikDB/packs
Sign in
officialyantrikdbsigned

yantrikdb-pack-api

yantrik/yantrikdb-pack-api@0.1.0·14 facts·1056 KB·4 downloads·by spranab

The YantrikDB pack API: sealing, signing, mounting, installing and trusting knowledge packs from Python — an API surface that did not exist before 2026-07-28.

yantrikdbpackspython api

covers

creating, sealing and signing YantrikDB packs from Python · mounting, installing and trusting packs in a YantrikDB database · yantrikdb Python pack API calls and their arguments

rules this pack installs (6)

Injected on every turn while mounted. Shown verbatim — a pack's rules are public by design.

Construction and dimensions: Open or create a database with `db = YantrikDB(path, 64)` — the second argument is the embedding dimension, and 64 is the bundled embedder's dimension, which packs use. Import with `from yantrikdb import YantrikDB`. Close with `db.close()` when done.
Record before sealing: A pack is sealed FROM a namespace, so content must be recorded first: `db.record_text(text, namespace=..., importance=0.6)`. Sealing an empty namespace produces an empty pack.
seal_pack refuses to overwrite: `seal_pack` raises if the destination file already exists. Seal to a fresh path, or delete the old file first.
Signing happens after sealing, on the file: `YantrikDB.sign_pack(path, secret_hex)` is a static method that operates on an already-sealed pack file. Keys come from `YantrikDB.generate_pack_keypair()`, which returns the tuple `(secret_hex, public_hex)` in that order.
Trust is a host decision, made before mounting: A valid signature from an unknown key mounts at the "unsigned" trust tier. To get the "signed" tier, the host database must first call `db.trust_publisher(public_hex, label)` — then mount.
mount is transient, install is durable: `db.mount_pack(path)` lasts only for the current process and never writes to the host database. `db.install_pack(path)` copies the pack beside the database and re-mounts it automatically on every future open. Check state with `db.mounted_packs()` and `db.installed_packs()`, both returning lists of dicts.

evaluation notes

skills.constitution — pack installs 6 always-on rule(s); they are shown verbatim on the listing for review

install

Native client — verifies against the registry, then installs:

curl -O https://packs.yantrikdb.com/client/yantrik_pack_client.py
python yantrik_pack_client.py install yantrik-yantrikdb-pack-api

Manual — download first, then:

yantrikdb pack info yantrikdb-pack-api-0.1.0.ydbpack
yantrikdb pack install yantrikdb-pack-api-0.1.0.ydbpack

Verify any copy of this file, wherever it came from:

curl "https://packs.yantrikdb.com/api/v1/verify?sha256=adb2b4c80b4dff65d344fffe10f07437c26825e41f3c6a7bf63e22088d54860d"

get it

Download 0.1.0
sha256
adb2b4c80b4dff65d344fffe10f07437c26825e41f3c6a7bf63e22088d54860d
digest
blake3:e685082980f8987cb2625a253dedc09e2275428271ba157df29f4ddd8f3c4b2b
signer
13a9232bc7829ea6a03e4bd6a0706c08f80ff4a2ecc83fd10062314acfb59683