Skip to content
 
 

Latest commit

 

History

4,026 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QSOLKCB / QEC

Deterministic quantum error-correction software, replayable evidence, and classical syndrome-transport experiments. QEC combines exact finite-code models with canonical JSON / SHA-256 receipts and validators that reconstruct results.

Latest Tests License: MPL-2.0

Release

Current release line: v177.1

Includes sparse qutrit construction and opt-in CSS / syndrome-delivery research. See the release history for changes and verification records. Release labels and contract milestones are separate from Python package metadata, which currently remains 173.0.0.

Try the labs

Open the browser-native Qutrit Harmonic Lab or Ququart Evidence Lab. For local/offline use, open the Qutrit lab or follow the Acoustic Lab guide. The hosted Ququart lab includes generated evidence that is not bundled in a fresh checkout.

Quick start

Requires Python 3.10+ and Git. From a terminal on Linux or macOS:

git clone https://github.com/QSOLKCB/QEC.git
cd QEC
python -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[dev]'
qec-qutrit
python scripts/generate_qec_research_evidence.py --check

On Windows, activate with .venv\Scripts\Activate.ps1 in PowerShell. qec-qutrit prints an exact bounded-error certificate; the research check verifies the retained synthetic fixture. See installation and troubleshooting for additional dependencies, and Rust TUI usage for the operator UI.

For the optional Rust TUI launcher, review the installer before running:

sh tui/install.sh

Tests

python -m pytest -q

Optional scientific/external backends may be skipped unless their extras are installed. Use python -m pytest -q -ra to inspect skips; see validation boundaries.

What is included

  • Exact qutrit and ququart models: finite-code correction and FER evidence. Qutrit · Ququart
  • Replayable receipts: canonical artifacts, source-bound claims, replication checks and decoder-governance boundaries. System documentation
  • Six classical switching models: Strowger, Panel, Crossbar, ESS, digital TDM and packet routing, with cross-era replay. Contracts
  • Acoustic syndrome transport: sampled classical waveforms, receiver checks and exact-model correction. Bridge and limits
  • Opt-in research: binary CSS presentation witnesses and synthetic delivery replay using an unchanged reference decoder. Scope and reproduction
  • Qutrit circuit conformance: pinned prime-field SUM/SWAP and toric-code fixtures, independently replayed against GF(3) algebra. Donor and limits

These are bounded software models and experiments. They do not establish physical fault tolerance, hardware thresholds, quantum-state transfer, or quantum advantage. Hashes bind declared bytes; they do not by themselves prove authenticity or scientific correctness. Governance receipts do not activate a decoder. QEC OS runtime/benchmark work remains deferred to v193.x; see the roadmap.

Documentation

Maintained by Trent Slade, QSOL-IMC. Licensed under MPL-2.0.

Repository layout

Current guides live in docs/; optional dependency profiles are described in requirements/. Historical media, opaque ZIP corpora and older reports are preserved in archive/.