Skip to content

Installation Guide

Document reference: GFTCL-INST-001 · Framework: GAMP 5 Category 5 · EU Annex 11 Qualified by: IQ — Installation Qualification

FortressAI Research Institute · Norwich, Connecticut Patents: USPTO 19/460,960 · USPTO 19/096,071 — © 2026 Richard Gillespie

The controlled procedure for installing and commissioning the GaiaFTCL vQbit Quantum VM. Completing this guide and passing IQ constitutes a qualified installation.

1. System requirements

Requirement Specification
Operating system macOS 26.0+ (LSMinimumSystemVersion)
CPU Apple Silicon (arm64) — M-series
Memory 16 GB minimum; capacity scales with unified memory (≈1 M cells/algorithm at 128 GB)
Disk ~1 GB for the app + growing append-only substrate store
Toolchain (build-from-source only) Swift 6.2+, Xcode Command Line Tools
Network Outbound to the federation mesh (NATS) and, for chain observation, operator-configured RPC

2. Install from the signed DMG (operators)

Production channel: v2 sovereign mesh — GaiaFTCL-v2-Sovereign.dmg via gaiaftcl@gmail.com access code.

  1. Request access — receive DMG + signed gftcl2.v1.… envelope (see version.json on apex).
  2. Verify integrity before opening: 
    shasum -a 256 ~/Downloads/GaiaFTCL-v2-Sovereign.dmg
curl -s https://gaiaftcl.com/downloads/GaiaFTCL-v2-Sovereign.dmg.sha256
    The two values must match exactly.
  3. Open the DMG and drag GaiaFTCL into Applications.
  4. On first launch, right-click the app and choose Open if Gatekeeper prompts.
  5. Mac binding panel — copy hash, paste operator code → Quantum Safe Wallet loads.

Mac binding panel

Quantum Safe Wallet

Spec: v2 activation gate.

3. Build from source (engineers)

cd cells/xcode
bash scripts/build_sovereign.sh        # builds Franklin.app + the DMG

Franklin.app is the single entry point; VQbitVM and FranklinConsciousnessService are bundled as child subsystems on the internal NATS bus.

4. Commission the configuration

Create the operator configuration under ~/.gaiaftcl/ before first operational use. The daemon refuses to start if required configuration is absent — this is correct, not an error. See the Configuration Specification for every file and field. Minimum set:

  • franklin_sovereign_authority_bounds.toml — Franklin's bounded authority
  • substrate_tunables.toml — substrate tunable values
  • cell_federation_context.toml — federation identity / mooring

5. Post-installation qualification (IQ)

Run the in-app qualification (⬡ → Run Qualification… in Franklin.app, or the SovereignQualificationRunner). IQ confirms, with no running stack required:

  • Franklin sovereign binary active; VQbitVM and FranklinConsciousnessService bundled;
  • NATS live on 127.0.0.1:4222; substrate schema valid (GRDB);
  • algorithm catalog complete; S4DeltaWire frozen at 53 bytes.

A passing IQ (all checks CALORIE) is the gate to operational use. Full criteria: IQ — Installation Qualification.

6. Verify the install operationally

gaiaftcl franklin status          # daemon PID, cadence, tunable state
gaiaftcl cell identity            # cell id + federation context public key
gaiaftcl franklin show-state      # Franklin's substrate-wide state projection

Re-run IQ after any DMG re-install, macOS upgrade, or toolchain update (see Operational Procedures → change control).

Federation-cosigned

This page's source is sealed in the GaiaFTCL federation manifest — page SHA-256 f19f7586a8fddda4…, manifest witness 3d999b305397d96c…, signed 2026-07-17T15:45:53Z by cell gaiaftcl-mac-cell. Verify with gaiaftcl wiki sign --all and compare wiki-all-signatures.json.