GDk9

Symbolic energy toolkit: a zero-dependency Python CLI, the KeySuite reference runtime, and a web console for the GDk9 implication grammar.

GDk9 treats letters as energetic operators. The gdk9 CLI analyzes, profiles, transforms and encrypts text with the GDk9 implication engine; KeySuite is the deterministic reference runtime for the GDk9 grammar, with conformance vectors; the KeySuite console is a local React UI over the same algebra.

Install

Requires Python 3.9+. The core CLI has no runtime dependencies.

git clone https://github.com/ao3575911/gdk9.git
cd gdk9
python -m venv .venv && . .venv/bin/activate
pip install -e .

Optional extras: pip install -e ".[secure]" (AES-GCM via cryptography), ".[dev]" (pytest, ruff, build), ".[egglog]" (egglog bridge, Python 3.11+).

Quickstart

gdk9 --version
gdk9 analyze "Hello, world!"
gdk9 profile "The quick brown fox jumps over the lazy dog"
gdk9 dcg classify FWEM
gdk9 kernel eval "FWEM"
python examples/01_analyze.py

KeySuite runtime (Python 3.10+):

cd packages/keysuite-runtime
pip install -r requirements.txt && pip install -e .
keysuite "C C . 3 3"
keysuite conformance conformance/vectors

KeySuite console (Node 22):

cd apps/keysuite-console
npm ci
npm test
npm run dev      # http://localhost:5173

More: Quickstart · CLI reference · API · Architecture · Alphabet handbook · Examples

Repository layout

Each subproject was merged with its full git history (git log -- <path>). legacy/ is kept for reference only and is excluded from lint and CI.

Running tests

# gdk9 CLI
pip install -e ".[dev]"
python -m pytest -q
ruff check .

# KeySuite runtime
cd packages/keysuite-runtime && python -m pytest -q && keysuite conformance conformance/vectors

# KeySuite console
cd apps/keysuite-console && npm ci && npm test && npm run typecheck

CI runs all three on every push and pull request to main.

License

The repository as a whole is licensed under the GNU Affero General Public License v3.0 or later.

LICENSES: subfolders keep their original licenses, each with its own LICENSE file: packages/keysuite-runtime/, apps/keysuite-console/ and legacy/gdk9-alphabet/ are MIT; legacy/gdk9-fork/ and legacy/symphi-engine/ are GPL-3.0.