Use VADRA with your own project.

1. Check the requirements

Validated installation: macOS on Apple silicon. Node.js 20.9+ (Node 22 deployment baseline), pnpm 11.9, Python 3.11, uv and Git. Install these prerequisites before continuing.

Protected local execution currently requires macOS sandbox containment. Ubuntu supports the saved public preview, not protected repair execution. Windows native installation is not validated.

VADRA preview is offered without a VADRA charge. Live model use requires your own supported provider access and consumes that provider’s allowance. Separately chosen API usage may be billed by its provider; this setup does not enable it or silently fall back to API billing.

Node.js · pnpm · uv installation

2. Download the source package

Version 2026.09.18-78ba770. This identified local-product distribution predates the browser sandbox; its Core and local workflow are unchanged. No dependencies, credentials or runtime data are bundled. Retained third-party source keeps its license notices; this is not an open-source license announcement.

SHA-256

3. Verify and install

In Terminal, open the folder containing both downloads. Stop if the checksum does not match. These commands install the package’s locked dependencies.

shasum -a 256 -c vadra-developer-preview-78ba770.tar.gz.sha256
tar -xzf vadra-developer-preview-78ba770.tar.gz
cd vadra-public-release
pnpm install --frozen-lockfile
(cd services/hermes-core && uv sync --frozen)

4. Start the local product

From the extracted vadra-public-release directory, use Terminal 1 for Core. This creates fresh isolated runtime state and selects deterministic adapters. It performs no model request.

export VADRA_LOCAL_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/vadra-local.XXXXXX")"
export VADRA_PRODUCT_DATA_DIR="$VADRA_LOCAL_ROOT/product"
export HERMES_GROUP_ROOT="$VADRA_LOCAL_ROOT/groups"
export HERMES_TASK_ROOT="$VADRA_LOCAL_ROOT/tasks"
export HERMES_ORCHESTRATION_ROOT="$VADRA_LOCAL_ROOT/orchestration"
export HERMES_MODEL_LOCK_ROOT="$VADRA_LOCAL_ROOT/model-lock"
export HERMES_STATE_FILE="$VADRA_LOCAL_ROOT/state.json"
export VADRA_MACHINE_ROOT="$VADRA_LOCAL_ROOT/machines"
export HERMES_CONSENSUS_ADAPTERS=deterministic
export HERMES_PLANNING_PROSE=retained
services/hermes-core/.venv/bin/python -m uvicorn \
  --app-dir services/hermes-core/src hermes_core.app:app \
  --host 127.0.0.1 --port 8787

In Terminal 2, open the same extracted directory and run:

pnpm dev

Open http://127.0.0.1:3000 after startup. Select and verify your Git repository, then choose This machine. Keep both services on loopback; do not expose your local installation publicly. Ctrl+C stops each service. If ports are already in use, follow the README’s independent-instance guidance—do not stop unrelated services.

5. Connect only when you choose

Install the official Codex / Claude Code CLI separately and use its own sign-in flow: codex login or claude auth login. VADRA never asks for your password, cookie or token. In onboarding or Settings, explicitly check login status. A separately consented live test uses provider allowance.

Authenticated is not the same as live inference, completed execution, independent review or protected authorization. Defaults remain deterministic; selecting live execution requires the normal local environment preparation and bound human approval. No hosted execution starts from this website.

Provider login and live tests · Preparation and recovery · Workspace verification

Current limits

The live artifact-review customer journey is still blocked in acceptance. Plan review and successful implementation tests do not certify an artifact. Required missing proof must still refuse protected action. Runner protocol tests are not certification of production multi-host/cloud jobs.

Prefer to explore without installation? Open the free browser sample.