Metadata-Version: 2.4
Name: omnis-key
Version: 0.1.4
Summary: OMNIS KEY — JourdanLabs' local-first, receipt-backed engineering workbench (VANTAGE, CADMUS, PROSPECTOR, LUNA), runnable from a pip install.
Author: JourdanLabs
License: UNLICENSED
Project-URL: Homepage, https://github.com/jourdanlabs/omnis
Keywords: omnis,code-audit,verification,governed,jourdanlabs
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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

```bash
pip install --upgrade omnis-key==0.1.4
```

**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

```bash
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

```bash
# 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.

🐦‍⬛ + 🔑
