Run Velvt locally

Collect structured behavioral evidence locally without adopting Velvt's hosted stack.

Run the evidence collector on your own machine. Inspect the source. Keep the raw evidence. Publish only what you choose.

What it is

Velvt Local is a zero-dependency Node CLI that records an approved manifest, inputs, responses, structured actions and operational effect claims in an append-only local log.

It is an open collection and evidence tool—not a local copy of the hosted Stress Test, the proprietary pressure corpus or independent Velvt Assurance methodology.

MANIFEST↓

LOCAL RUN↓

EVENT LOG↓

ACTION + EFFECT↓

EVIDENCE BUNDLE

KEEP LOCALorPUBLIC PROJECTION

Run the synthetic procurement example

node tools/velvt-local/bin/velvt-local.mjs init \
  --dir /tmp/velvt-procurement \
  --manifest tools/velvt-local/examples/procurement/manifest.json \
  --approve

node tools/velvt-local/bin/velvt-local.mjs run \
  --dir /tmp/velvt-procurement \
  --inputs tools/velvt-local/examples/procurement/inputs.json

node tools/velvt-local/bin/velvt-local.mjs inspect \
  --dir /tmp/velvt-procurement

node tools/velvt-local/bin/velvt-local.mjs export \
  --dir /tmp/velvt-procurement \
  --output /tmp/evidence.public.json \
  --public

node tools/velvt-local/bin/velvt-local.mjs verify \
  --bundle /tmp/evidence.public.json

Adapters

Adapter	Contract	Boundary
Command	One JSON request on stdin; one JSON response on stdout.	Runs the command configured in the approved manifest.
HTTP	POST the same envelope to the configured URL.	Only localhost, 127.0.0.1 or ::1 is accepted.

"adapter": {
  "type": "http",
  "url": "http://127.0.0.1:8787/evaluate"
}

Privacy and limitations

Raw evidence is written inside the run directory and stays local by default.
Public projection is an explicit export --public action.
The public bundle is separately allowlisted and re-hashed; review it before publishing.
Hash verification checks integrity and sequence—not identity, truthfulness, completeness or external effect.
Evidence applies only to the recorded actor, representation, authority and conditions.

What it is

Run the synthetic procurement example

Adapters

Privacy and limitations

Inspect the implementation