Independent network appliances running AI Power Grid validators

Validator preview

Check the Grid independently.

Run a lightweight node that receives targeted assignments, evaluates worker responses, and signs compact evidence. It needs a CPU and an internet connection, not a GPU.

Install validatorSource Join preview cohort

Before you run it

Preview means evidence, not authority

There are no validator rewards, staking, slashing, or worker penalties in this release. Until independently operated nodes and shared 3-of-5 probe groups are proven, this is distributed testing rather than decentralized validation.

  • Grid-issued assignments only
  • Wallet-signed registration and evidence
  • No inference, funding, or account-management scope

Two Linux operators needed for the initial gate

One independent candidate is qualifying now. The first gate requires three unrelated operators, and one person or organization counts once even if it runs several nodes. Volunteer through the tracked cohort issue, then complete a 72-hour no-reward qualification.

Volunteer to run a node Cohort runbook

Live preview cohort

Registration is not qualification

These are current public operational counts. A validator only adds independent quorum weight after its operator and 72-hour run are reviewed. Preview evidence still has no economic or routing effect.

Network status
Fresh heartbeats
9
Participating
9
Verified independent
0
Assignments completed
702

Current release adoption

2 fresh validators report v0.1.0-preview.18; 7 still report an older preview.

Upgrade in place and keep your configuration and node identity. Do not re-enroll to upgrade.

Get v0.1.0-preview.18

Check your validator

One ID, one clear status

Enter the public ID printed by the validator. This lookup never asks for an API key, wallet address, or private key.

Install

Verified downloads

Every archive ships with a SHA-256 manifest, SPDX SBOM, and GitHub build provenance. The installer checks the archive before executing it.

Download Linux installer
Linux x64 Linux ARM64 macOS Apple Silicon Windows x64
SHA256SUMSSPDX SBOMRelease notesLinux systemd guide

Already running a node?

In the preview.17 or newer operator app, choose Check for updates, then Update and restart for v0.1.0-preview.18. The app verifies the release and preserves your configuration, node identity and pending evidence.

Older apps need one manual executable replacement. For systemd or Docker, update your managed installation instead; the app does not restart external services. Keep the same private configuration and state directory. Do not re-enroll.

Upgrade and recovery guide

Linux server: keep it alive for 72 hours

This is the recommended cohort path. It installs the frozen v0.1.0-preview.18 binary, creates a dedicated validator identity, and runs it as a hardened systemd service. Setup prompts locally; no private key belongs in these commands.

  1. 1. Install, enroll, and check the node

    curl -fsSLO https://github.com/AIPowerGrid/grid-validator/releases/download/v0.1.0-preview.18/install-validator.sh
gh attestation verify install-validator.sh --repo AIPowerGrid/grid-validator
bash install-validator.sh
cd ~/.aipg-validator
aipg-validator enroll
aipg-validator self-test
aipg-validator check --no-probe

  2. 2. Verify and install the pinned service helper

    curl -fsSLo install-systemd.sh \
  https://raw.githubusercontent.com/AIPowerGrid/grid-validator/778e9a1f2263094918998954c62678dba6b90334/scripts/install-systemd.sh
printf '%s  %s\n' \
  32adb391ab0591a55b3cbefce851fb0b9965685dabfc26706d6458e488b5defd \
  install-systemd.sh | sha256sum -c -
chmod 700 install-systemd.sh
sudo AIPG_VALIDATOR_EXEC="$HOME/.local/bin/aipg-validator" \
  AIPG_VALIDATOR_WORKDIR="$HOME/.aipg-validator" \
  ./install-systemd.sh --dry-run
sudo AIPG_VALIDATOR_EXEC="$HOME/.local/bin/aipg-validator" \
  AIPG_VALIDATOR_WORKDIR="$HOME/.aipg-validator" \
  ./install-systemd.sh

    Helper source is pinned to reviewed commit 778e9a1 and checked before execution. It never follows a moving branch or pipes a download into a shell.

  3. 3. Confirm the service and accepted evidence

    sudo systemctl status aipg-validator --no-pager
sudo journalctl -u aipg-validator -f

Stop any validator child started by the local app before enabling systemd. Keep the same .env and validator ID for the entire qualification; do not re-enroll during an upgrade or restart.

First-time setup

aipg-validator app

Desktop path: on Windows, extract the download and double-click aipg-validator.exe. Choose 8 to open the local operator app, then choose Set up and start and confirm Create node account. The node starts automatically with the saved configuration. Existing operators keep their configuration and choose Start validator.

Setup creates a dedicated node account and saves its signing key locally. No personal private key, funded wallet, Google, or GitHub login is needed. Existing-account pairing is not available yet; keep your existing node configuration if you already run a validator.

Confirm acknowledged heartbeats and accepted evidence in the app. Closing the browser tab leaves it running; Exit app stops its node and closes the local server. Never share its private localhost URL.

Full setup and headless server guide

Docker on Linux x64 / ARM64

docker pull ghcr.io/aipowergrid/validator:v0.1.0-preview.18

The public, version-pinned image can create a new node without a source checkout. The Docker guide enrolls it as your host user, mounts credentials read-only after setup, and preserves the assignment and evidence journal across restarts.

Open Docker quickstart

Keep the same private config directory and val_*identity for the full qualification. Prereleases never publish or replace latest.