Getting started

Every command below is checked against this repository's own CI (the "Offline kit, from a bare checkout" job runs this exact sequence on a fresh Python 3.11/3.12/3.13 install on every push) — not hand-typed and hoped for.

Install

git clone https://github.com/iceccarelli/neuralbridge.git
cd neuralbridge
python -m venv .venv && source .venv/bin/activate
pip install -e '.[assurance-attest]'

The free path: the offline enrolment kit

python -m assurance kit init plant/
python -m assurance kit check plant/kit.json   # reads only — the report your IT department signs off on
python -m assurance kit run  plant/kit.json --out plant/out

You get plant/out/report.html, plant/out/evidence.db, and plant/out/attestation-request.json. The run arms a guard over the process's own socket layer, refuses every outbound connection — including name resolution — and seals a record of any attempt into your own ledger.

Run the API

pip install -e '.[assurance-api]'
uvicorn assurance.api.service:app --port 8000
# http://127.0.0.1:8000/docs

GET /v1/plans returns the pricing table generated from the entitlements the software enforces — the same table on Pricing and on neuralbridge.io.

See a full worked example

python -m assurance report demo --out demo/

Builds a worked fleet — real collection, real normalisation, real findings — and writes demo/report.html, a self-contained page with no scripts and no network calls.

Next

• Assurance engines — what each command establishes, and the finding nobody else produces.
• Deploying the register — Fly.io, Stripe, and what to check after deploying.