hakodesh

Host-agnostic Python CLI and SDK. After pip install hakodesh the user book is empty. Your LLM or agents mint spells, enchantments, wards, and combos as they need them.

PyPI name, import, and command: hakodesh.

Install

pip install hakodesh

Data home: HAKODESH_HOME or the platform user-data directory for hakodesh. Never ~/spells.

Kernel commands

These are the runtime, not starter spells:

--like on an empty book uses the kind template in the wheel. After one spell exists, --like <that> copies its shape.

Every mint and cast emits hakodesh.event/v1. Akashic is SHA-256 linked and HMAC-SHA256 signed. Grimoire is Merkle-sealed with the same chain key. The keystore is $HAKODESH_HOME/keys (0700/0600), minted on first seal, never in the wheel.

Notifications default to none. The package does not write LaunchAgents or editor hooks until you mint and bind an enchantment.

דיאלעקטוס: the dialect

The protocol is Hebrew end to end, in a constructed dialect: a Latin lexicon carried in traditional Hebrew script, on the Yiddish and Ladino model. Every protocol token is derived from a Latin lemma by one total transliteration (hakodesh.dialectus), so it is a novel string with no prior corpus meaning, yet an English reader can decode it through its Latin root. Verbs are the Latin perfect, first person singular (verificavi, custodivi, scripsi); objects are Latin nouns; statuses are perfect passive participles. Prose stays Hebrew; tokens are dialect. The LLM reads the protocol and converses with the user in the user's own language.

Orthography: plene, no nikud; qu→קוו, ph→פ, th→ט, ch→ק, sh→ש, ae/oe→ע, x→קס, f/p→פ, c/k/q→ק, i/j/y→י, o/u→ו, v/w→וו; doubled letters collapse; word-initial i/o/u take א; an א separates וו from a vowel ו; final forms on the last letter.

Kernel verbs

devra --help lists exactly these under lexicon. The traditional-Hebrew twins of 0.3/0.4 (טבעתי, שמרתי, ...) and the English names still dispatch as silent legacy aliases through 0.5.x and are removed in 0.6.0. All spellings are reserved: mint refuses them as a whole artifact name.

Status vocabulary

Closed and declared by protocol: פערמיסום (permissum), קומפלעטום (completum), נעגאטום (negatum), דעפעקטום (defectum), קלאוסום (clausum), פרעוויסום (praevisum), אינקעפטום (inceptum), סינקרונאטום (synchronatum), אפערטום (apertum), וועריפיקאטום (verificatum), and the rest in dialectus.STATUS. Event kinds, notification policies, severities, actor roles, trace sources, outcomes, correctness, procedure statuses and decisions are written in the dialect and read in either spelling within hakodesh.event/v1; the published descriptor lists both. JSON keys stay English until the v2 schema bump (0.6.0).

Errors

Every kernel error carries a stable error_code (ward.unknown, mint.reserved, ...) and Hebrew prose. Tests assert on codes, never on prose. Artifact names may be lowercase Latin or Hebrew, digits and dashes; every lookup normalizes to NFC.

דיקסי רעקענסוי                          # == devra spellbook
devra פערקוסי פרובאווי-קאנון --confirm   # mint a dialect-named spell
devra פרובאווי-קאנון                     # cast it; receipts land in receipts/פרובאווי-קאנון/

Development

python -m pip install -e ".[dev]"
python -m pytest                 # unit, property and tripwire tests
python -m build                  # wheel + sdist into dist/

The package depends on nothing but platformdirs. It has no opinion about where your source of truth lives or how you publish; nothing in the wheel or the sdist names a host, a storage account or a vault, and tests/test_agnostic.py keeps it that way.

SDK

from hakodesh.catalog import catalog
from hakodesh.mint import mint
from hakodesh import events, akashic, grimoire
from hakodesh.enchant import bind, lift
from hakodesh.ward import unlock
from hakodesh.combo import seal, cast

Book law

The book is per user, under HAKODESH_HOME. A fresh install has zero spells, enchantments, wards or combos, and nothing is intrinsic: discovery picks up a file the moment it lands under HAKODESH_HOME/book/. The repository's workshop/ is a book as source: mint from it with --from; it is not in the wheel and never lands in a book by itself (docs/PROTOCOL.md, §Book law).