omnis-key 0.1.0

OMNIS KEY — JourdanLabs' local-first, receipt-backed engineering workbench (VANTAGE, CADMUS, PROSPECTOR, LUNA), runnable from a pip install.

omnis-key

OMNIS KEY — JourdanLabs' local-first, receipt-backed engineering workbench, runnable from a pip install.

OMNIS runs entirely on your machine. Its deterministic engines — VANTAGE (code audit), CADMUS (spec creation), PROSPECTOR (estate discovery), and LUNA (persistent, receipt-backed memory) — are governed by the BIFROST gate and a hash-chained LUNA ledger, so every action carries an auditable receipt. Receipts over fluency.

Why pip

This package exists so OMNIS can be procured and vetted through the standard Python supply chain (pip install) in environments that prefer it. The engine is bundled as audited JavaScript and launched through a local Node.js runtime.

Install

pip install omnis-key

Requires Node.js ≥ 18 on your PATH (https://nodejs.org). The wheel bundles the OMNIS engine; Node runs it locally — nothing is sent off the machine unless you explicitly configure a cloud model lane.

Run

omnis                 # full workbench; agents can use cloud LLMs if keys are set
omnis --lockdown      # air-gapped: every cloud model lane is refused (data can't leave)
omnis --no-agents     # workbench only: deterministic tools, no agent chamber
omnis --port 8790 --data-dir ~/.omnis/workspace

omnis starts a local server on 127.0.0.1 and opens the workbench in your browser. Workspace data + the LUNA ledger live under ~/.omnis/ by default.

Air-gapped / regulated environments

--lockdown disables every network model lane at the adapter call site (not just a status flag), leaving the local and manual lanes only. The deterministic workbench works fully offline. Combine with --no-agents for a pure, no-model-lanes build.

Build from source

# from the repo root
npm run build                              # build the engine
npm --prefix desktop/renderer run build    # build the UI (optional)
pypi/build_wheel.sh                         # bundle engine + build wheel/sdist
pip install pypi/dist/omnis_key-*.whl

Publishing to PyPI (twine upload dist/*) requires a JourdanLabs PyPI API token.

🐦‍⬛ + 🔑