Skip to content
GaiaFTCL

The Mac vQbit Quantum VM

GaiaFTCL's quantum operating environment, packaged for macOS on Apple Silicon. The vQbit virtual machine is the substrate — the C⁴ rail composes operations inside it. Download, mount, run.

Download for macOS · Apple Silicon Direct .dmg link

Version 1.0.0 macOS 13+ · Apple Silicon (arm64) · ~117 MB

Substrate
vQbit VM

M⁸ = S⁴ × C⁴ quantum substrate running natively.

Platform
macOS · arm64

Built and signed for Apple Silicon.

Delivery
Mesh-served

Distributed across the gaiaftcl.com cell mesh.

Install

  1. Download the disk image, then open GaiaFTCL.dmg.
  2. Drag GaiaFTCL into Applications.
  3. On first launch, right-click the app and choose Open to clear Gatekeeper.
  4. The vQbit VM boots the substrate and the C⁴ rail comes online.

Verify your download

Each release ships a SHA-256 checksum. Confirm integrity before you run it:

# compare against the published checksum
shasum -a 256 ~/Downloads/GaiaFTCL.dmg
curl -s https://gaiaftcl.com/downloads/GaiaFTCL-latest.dmg.sha256

The two values must match exactly.

Use it from Python

The substrate is readable from Python through the federation-verified gaiaftcl wrapper. Franklin stays the only writer; the client reads the append-only, federation-cosigned tables through Franklin's cell surface.

pip install gaiaftcl            # base client
pip install gaiaftcl[all]       # + numpy / pandas / sklearn / biopython / rdkit / ase / pymatgen / root bridges

from gaiaftcl import FranklinClient

# reads ~/Library/Application Support/GaiaFTCL/substrate.sqlite (read-only)
with FranklinClient.connect() as franklin:
    for hb in franklin.heartbeat_history(limit=5):     # Franklin's per-60s sovereign cycle
        print(hb.tick_at_iso, hb.observations_count)

    wallet = franklin.local_wallet()                    # QFOT + Euro balances (self-custody)
    print(wallet.qfot_balance_canonical, wallet.euro_balance_canonical)

    for d in franklin.shor_demonstrations(limit=3):     # V188 Shor break evidence
        print(d.wallet_label, d.terminal)

Every row carries a federation cosignature you can verify bit-exact, and eight industry bridges turn substrate evidence into your stack's native types (numpy, pandas, scikit-learn, biopython, rdkit, ase, pymatgen, root). The full API is in Python Wrappers.

The full wiki

Everything the cell carries is in the left navigation — the substrate-mathematical foundation, the post-quantum wallet proof, the CLI reference, the schema catalog, Franklin architecture, and the domain catalogs. Use the search box up top to jump to anything.