QECTOR Claude Plugin

📖 Overview

QECTOR Claude Plugin is the official integration of the QECTOR quantum error correction (QEC) engineering and research environment for Claude Code and Claude Desktop. Built on qector-decoder-v3, it mathematically enforces $H c \equiv s \pmod 2$ across 10 code families and 5 MWPM/BP-OSD backends, ensuring fail-closed integrity for enterprise and academic quantum research.

Zero Egress · Strict Math · Fail-Closed The plugin runs 100% locally and never transmits QEC simulation telemetry to the cloud.

This repository is the app-free plugin companion to the QECTOR Decoder Workbench desktop application (Windows / Linux). Both v1.0.1 workbench releases are fully compatible with this plugin — see the Workbench Compatibility section.

Related MCP server: Qwen3-Coder MCP Server

🚀 Quick Start

1. Clone and install

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin
python -m pip install -r requirements.txt
python scripts/qector_runtime_check.py

2. Claude Desktop GUI installer (Windows)

Instantly registers QECTOR as a first-class Extension inside Claude Desktop Settings:

.\scripts\install_windows_connector.cmd

(A PowerShell equivalent ships as scripts/install_windows_connector.ps1. Linux and macOS use the Claude Desktop extension in .claude-desktop-extension/.)

3. Claude Code marketplace integration

claude plugin marketplace add GuillaumeLessard/qector-claude-plugin
claude plugin install qector@qector-tools

4. Optional: guided system setup (with safety approbation)

python scripts/qector_system_setup.py --check-only   # read-only audit, no changes
python scripts/qector_system_setup.py --confirm      # execute after user approval

📥 Downloads

v1.0.2 release assets (in dist/, each with a .sha256 sidecar):

Requirements: Python 3.9+ (tested on Python 3.12), qector-decoder-v3==1.0.0, mcp==1.26.0, numpy>=1.26,<2.3, cryptography>=48.0.1,<50. All pinned in requirements.txt against the published wheel constraints.

🧩 Ecosystem

🤖 MCP Servers (37 Tools)

Two local stdio Model Context Protocol servers run against the qector-decoder-v3 core:

qector-library tools: list_code_families, list_decoders, get_license_info, decode_syndrome, decode_single, threshold_sweep, build_code_from_matrix, compat_report

wilson_ci, wilson_table, logical_coset_score, dem_inspect, dem_collapse_parallel, code_family_info, code_export_matrices, code_logicals_inspect, code_distance_check, pymatching_compat_check, sinter_decoder_list, qiskit_plugin_check, hardware_probe, license_active_check, env_block, compat_report, workbench_probe, artifacts_sha256, artifact_metadata_check, decode_faithfulness_check, hot_path_microbench, stim_circuit_probe, sinter_task_template, workload_hash, theorem_lookup, glossary_lookup, reproduction_command_lookup, system_setup, configure_claude_desktop

💬 Commands (13 Slash Commands)

🎭 Agents (5 Specialized Personas)

🛠️ Skills (28 Domain Primitives)

qector-core, qector-architecture, qector-math-foundations, qector-codes-builder, qector-bp-osd, qector-two-stage-css, qector-space-time, qector-decoders-deep-dive, qector-dem-pipeline, qector-sinter, qector-ler-methodology, qector-pymatching-compat, qector-batch-decoding, qector-orchestration, qector-reproducibility, qector-testing-strategy, qector-deployment, qector-release-engineering, qector-licensing, qector-services, qector-glossary, qector-educator, qector-researcher, qector-developer, qector-sysadmin, qector-hardware-engineer, qector-roadmap, qector-workbench

🏗️ Architecture

┌──────────────────────────────────────────────────────────┐
│                 QECTOR Claude Plugin v1.0.2               │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐ │
│  │ 13 Commands │  │  5 Agents    │  │  28 Skills       │ │
│  └──────┬──────┘  └──────┬───────┘  └────────┬─────────┘ │
│         └────────────────┼───────────────────┘           │
│                          ▼                              │
│  ┌─────────────────────────────────────────────┐        │
│  │  qector-library MCP (8 tools)   stdio only  │        │
│  │  qector-bench   MCP (29 tools)  stdio only  │        │
│  └──────────────────────────┬──────────────────┘        │
│                             │                           │
│              ┌──────────────▼──────────────┐            │
│              │  qector-decoder-v3 1.0.0     │            │
│              │  (Rust/PyO3 engine, local)   │            │
│              └─────────────────────────────┘            │
└──────────────────────────────────────────────────────────┘

Claude Desktop Extension — a fully integrated custom connector (manifest_version: 0.3, in .claude-desktop-extension/) that displays native UI controls, documentation, and the QECTOR icon directly within Claude Desktop → Settings → Connectors.

🛡️ Core Engineering Guidelines

1. Mathematical Strictness — Every single syndrome decoding must verify $H c \equiv s \pmod 2$. Approximations are rejected.

2. Zero-Egress Security — Operations run 100% locally. The plugin never transmits QEC simulation telemetry to the cloud, protecting proprietary hardware IP.

3. Fail-Closed Design — Mismatched matrix dimensions, unrecognized code families, or invalid distance requests immediately raise deterministic errors rather than silently corrupting the quantum state.

4. Statistical Rigor — All LER threshold sweeps include exact Wilson 95% binomial score intervals. Point estimates without bounds are rejected.

The mathematical authority is the QECTOR Decoder v3 reference manual v1.0.0 (DOI: 10.5281/zenodo.21941046); the plugin is grounded against all 16 Theorems, 27 Chapters, and 5 Appendices.

🤖 Workbench Compatibility

The official QECTOR Decoder Workbench desktop application — both the Windows (qector-decoder-workbench-windows, portable .exe) and Linux (qector-decoder-workbench-linux, AppImage) v1.0.1 releases — is fully compatible with this plugin:

• Both workbench releases bundle the same qector-decoder-v3 1.0.0 backend this plugin pins (qector-decoder-v3==1.0.0) — versions match exactly.

• Use the workbench's 85-tool --mcp server, this plugin's two stdio MCP servers, or all three at once — every transport is local-only with zero network egress.

• The plugin's workbench_probe tool detects a running workbench and reports its version, tool count, and MCP protocol status.

• Workbench artifacts (exports, benchmark reports, deposit sidecars) are verified by the plugin's artifacts_sha256 / artifact_metadata_check tools.

📋 System Requirements

📚 Documentation

📄 License

Proprietary, source-available software. Copyright (c) 2026 Guillaume Lessard and iD01t Productions. See LICENSE.md.

The underlying qector-decoder-v3 backend is separately licensed:

• ✅ Free for personal, academic, educational, and non-commercial research

• 💼 Commercial use (company R&D, SaaS, hosted API, OEM, redistribution) requires a paid license

• 🔄 60-day commercial evaluation available, creditable against a license

🤝 Support & Contact