Reference Implementations

Piea — the complete AIEP architecture in production

Piea is an enterprise AI assistant built from scratch on the full AIEP Piea Surface (P116–P128). It is not a subset implementation. It is a production system running GENOME R1–R8, streaming live evidence artefacts over SSE, committing every response as a response_hash, archiving dissent records as governed ledger artefacts, replaying reasoning chains step by step, and detecting semantic ambiguity to answer both valid interpretations with shared evidence.

Piea is the proof that the AIEP architecture is complete, coherent, and powerful enough to build production systems on.

→ Full Piea specification  ·  → Try Piea at piea.ai

Forecast — construction management built on AIEP

Forecast is the first AIEP vertical SaaS — a full-stack construction project management platform where every legally significant event (instruction, variation, notice, snag, incident) is automatically committed to an evidence substrate backed by AIEP GENOME. Evidence is not a feature. It is a consequence of how the platform works.

→ Full Forecast specification

QARDL — AIEP proof of identity

QARDL is the first product to use AIEP as a proof-of-identity layer. Cryptographically verifiable professional identity cards for UK tradespeople, contractors, and regulated professionals. Every credential — a CSCS card, a Gas Safe registration, a Companies House number — is committed as a GENOME artefact, chain-linked, divergence-checked, and optionally attested under the AIEP governance protocol.

The QIC (QARDL Identity Code) is a machine-readable, GENOME-derived identity handle:

QARDL-USR-3a8f1c-7    (individual)
QARDL-ORG-b72d04-3    (company)
QARDL-AGT-c91f22-9    (AI agent — P118)

→ Full QARDL specification

AIEP Miner — verifiable control of autonomous systems

AIEP Miner is an open-source reference implementation of the AIEP protocol applied to a real-world autonomous system. It connects to ASIC cryptocurrency miners and demonstrates that an autonomous system operating on physical hardware, under real financial pressure, in an adversarial environment, can be fully governed — with every decision, every suppressed action, and every failure committed as tamper-evident evidence.

This is not a cryptocurrency product. It is a controlled demonstration that autonomous systems can be governed.

→ Full AIEP Miner specification

Open-source repositories — 22 implementations

Quick Install

Every Python repo ships with a pyproject.toml, zero runtime dependencies, and a unified CLI. All 19 packages install with the same 3-command flow:

# 1. Install from zip (no git clone needed)
pip install https://aiep.dev/downloads/repos/<name>-v<version>.zip

# 2. Verify LOCKFILE and Canon constants
<name> --self-test

# 3. Run as a module
python -m <pkg_name> --version

Example — install and run aiep-mirror (zero-friction):

# One-click install (pre-built wheel, no compiler needed)
pip install https://aiep.dev/downloads/repos/aiep_mirror-2.1.0-py3-none-any.whl

# OR install from source zip
pip install https://aiep.dev/downloads/repos/aiep-mirror-v2.1.0.zip

aiep-mirror init          # auto-detect config
aiep-mirror build         # build .well-known/aiep/
aiep-mirror verify        # verify all hashes

All packages also expose python -m <pkg_name> --self-test for environments without PATH entry points.

Highlighted Repositories

aiep-hub-validator TypeScript v2.0.0

15-check endpoint validator for AIEP Mirror surfaces — pre-compiled, SSRF guard, zero runtime dependencies.

Validates a live .well-known/aiep/ surface against the full specification. 15 structural checks, JSON schema compliance, canonical hash field verification, SSRF guard. Pre-compiled — no build step needed.

# Validate a live mirror endpoint
node repos/aiep-hub-validator/dist/cli.js --site https://aiep.dev

# Validate this site's local build (generates v2 manifest first)
npm run validate:deep

# Run Canon kernel self-test
npm run validate:canon

Implements: P60 · P61 · P62 · P63 · Source: repos/aiep-hub-validator/ · Download zip

aiep-genome-sdk Python v1.2.0 — 115 tests

Two-command AIEP adoption for any Python project — init or adopt.

The Genome SDK bridges any Python project to the AIEP kernel. Two modes:

• aiep-genome init — scaffold a brand-new AIEP-compliant project in one command (4 patterns: bare, evidence-ledger, mirror, governance)
• aiep-genome adopt — auto-detects your existing project structure and injects the genome layer with zero manual wiring

The frozen kernel (R1–R8 canon, I1–I6 invariant gates, P16 Negative Proof, CC-001–CC-005 constitutional constraints) ships as a pure-stdlib package with zero runtime dependencies.

# Fastest install (pre-built wheel)
pip install https://aiep.dev/downloads/repos/aiep_genome_sdk-1.2.0-py3-none-any.whl

# Or from source zip
pip install https://aiep.dev/downloads/repos/aiep-genome-sdk-v1.2.0.zip

# Start a new AIEP-compliant project
aiep-genome init my-service --name my-service --pattern evidence-ledger

# OR adopt an existing project (run inside it)
cd existing-project
aiep-genome adopt               # auto-detects pattern
aiep-genome adopt --dry-run     # preview without writing
aiep-genome verify              # 6-check compliance audit

Implements: P01 · P10 · P14 · P16 · Source: repos/AIEP-GENOME-SDK/ · Download zip · Download wheel

aiep-mirror Python v2.1.0 — 106 tests

Builds and validates the AIEP .well-known/ machine-readable web surface.

Generates and validates the complete /.well-known/aiep/ directory structure from HTML source. Canon determinism self-test, policy hash verification (FC §§4), and capability hash binding (FC §§3) all verified. Zero-friction CLI: init auto-detects your framework’s build output; no flags required on subsequent builds.

# Fastest install (pre-built wheel)
pip install https://aiep.dev/downloads/repos/aiep_mirror-2.1.0-py3-none-any.whl

# Or from source zip
pip install https://aiep.dev/downloads/repos/aiep-mirror-v2.1.0.zip

# Zero-friction three-command workflow
aiep-mirror init          # creates .aiep-mirror.json, auto-detects dist/out/_site
aiep-mirror build         # reads config, outputs .well-known/aiep/
aiep-mirror verify        # re-reads config, checks all canonical hashes

Implements: P60 · P61 · P62 · P63 · Source: repos/aiep-mirror/ · Download zip · Download wheel

aiep-evidence-ledger Python v2.0.0 — 46 tests

Deterministic, append-only, cryptographically anchored evidence ledger — foundational layer.

Ships with AIEP_v1.0.0_Canonical.json (a fully conformant reference artefact) and check_canon_determinism.py — proves canonicalisation produces a bit-identical hash across runs, environments, and Python versions.

aiep-evidence-ledger --self-test
python repos/ledger_v2/scripts/check_canon_determinism.py
python repos/ledger_v2/scripts/verify_sums.py

Implements: P01 · P10 · P14 · Source: repos/ledger_v2/ · Request access

aiep-recall-substrate Python v1.0.0 — 133 tests

Multi-cycle recall state substrate — highest test count in the stack.

Implements deterministic recall state management across multiple cycles with invariant-gated execution control. 133 tests cover recall admission, cycle tracking, and frontier management.

pip install https://aiep.dev/downloads/repos/aiep-recall-substrate-v1.0.0.zip
aiep-recall-substrate --self-test

Implements: P41 · P83 · Source: repos/aiep-recall-substrate/ · Download zip

aiep-divergence-proof Python v1.0.0 — 129 tests

Divergence detection and Negative Proof Integrity.

Implements the Negative Proof Integrity Commit (NPIC) scheme and environment attestation. Proves the Canon produces no false divergence signals and node fingerprints are stable across reboots.

pip install https://aiep.dev/downloads/repos/aiep-divergence-proof-v1.0.0.zip
aiep-divergence-proof --self-test

Implements: P37 · P46 · Source: repos/aiep-divergence-proof/ · Download zip

aiep-node TypeScript v1.0.0 — Hardware Substrate Demonstration

A locally runnable proof of the AIEP hardware governance architecture — power-governed reasoning, live evidence ingestion, dissent detection, and signed substrate migration.

Instantiates a full cryptographic substrate node in a zero-dependency Node.js/TypeScript runtime. ECDSA P-256 identity minted from WebCrypto on every boot, 15-second evidence ingestion cycle against four live legislative sources (legislation.gov.uk, bills.parliament.uk, eur-lex.europa.eu, api.congress.gov), four-state power governor with capability gating, negative proofs issued on every blocked operation, and sealAndMigrate() auto-triggered at State D. Live web dashboard at http://localhost:9001 via SSE.

npm install
npm start
# Open http://localhost:9001

# Or run the automated A→D→A power degradation demo:
POWER_DEMO=1 npm start

Implements: GB2519826.8 · P89 · P99 · P16 · P83 · GENOME R1–R8 · Available under evaluation licence · Full explainer · Hardware thesis

Running Tests Locally

All Python repos have zero runtime dependencies (stdlib only). Only pytest is needed for tests.

# Install pytest
pip install pytest

# Install a single repo from zip
pip install https://aiep.dev/downloads/repos/aiep-mirror-v2.1.0.zip

# Or install from source (editable mode)
pip install -e repos/aiep-mirror

# Run tests for one repo
cd repos/aiep-mirror
python -m pytest --tb=short -q

# Quick CLI self-check (all repos support this)
aiep-mirror --self-test
python -m aiep_mirror --self-test   # module form

All 22 Repositories