Metadata-Version: 2.4
Name: vaerion
Version: 0.1.15rc1
Summary: Vaerion — the AI-native development engine: deterministic runtime, broker-governed autonomy, hash-chained journals, receipts, and permanent provenance. Evidence, not branding.
Author-email: Auren <auren@vaerion.dev>
License: Apache-2.0
Project-URL: Repository, https://github.com/VaerionLab/vaerion
Project-URL: Issues, https://github.com/VaerionLab/vaerion/issues
Project-URL: Changelog, https://github.com/VaerionLab/vaerion/blob/main/CHANGELOG.md
Keywords: ai,agents,determinism,audit,provenance,journal,local-first,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# vaerion — PyPI distribution


## PyPI naming strategy (decision of record, 2026-10-03)

Two Python distributions exist in this repository and they must not
collide on PyPI:

| Distribution | PyPI name | Provides | Source |
|---|---|---|---|
| CLI launcher wheel | `vaerion` | the `vae` console command | `packaging/python/` |
| SDK | `vaerion-sdk` | the `vaerion` import (Agent / VaeDaemonClient) | `sdks/python/` |

This mirrors the npm/JVM rows of record: npm `vaerion` (CLI) vs
`@vaerion/sdk`; Maven `dev.vaerion:vaerion-sdk`. The SDK import name
remains `vaerion` in both layouts. Registry publication of both
distributions remains Founder-gated; PyPI `vaerion` measured 404
(unclaimed) on 2026-10-03.

`pip install vaerion` installs the `vae` console launcher plus the packaged
engine source. Python is the delivery channel, not the substrate: the
launcher resolves the Bun runtime (ADR-0018) and `exec`s the engine's own
`main()` — identical exit codes and streaming behavior to every other
channel. A missing Bun runtime produces a taught error (E1600, exit 2)
with the exact install command for the detected OS, never a traceback.

```sh
pip install vaerion
vae --help
```

## Build the publishable wheel

```sh
sh packaging/python/make-package.sh
# -> dist/python/vaerion-<version>-py3-none-any.whl (+ sdist)
```

The wheel is an INPUT to publication (Founder-gated, risk-ledger F-5).
Offline verification without any registry:

```sh
python3 -m venv /tmp/vaerion-venv
/tmp/vaerion-venv/bin/pip install --no-deps dist/python/vaerion-<version>-py3-none-any.whl
/tmp/vaerion-venv/bin/vae --version
```
