QECTOR Workbench
The free desktop application and Model Context Protocol server for QECTOR Decoder v3. Each v1.0.7 release (Windows/Linux) names 19 kinds: 17 concrete decoder configurations plus the AutoDecoder and Auto Router orchestration entries. It also covers 10 quantum code families, a visual circuit builder, and an 85-tool MCP server, with a bundled qector_decoder_v3 1.0.0 backend. Available for Windows x64 and Linux x64. Ships as a portable executable: each one is self-contained, bundling its own Python runtime, scientific stack, and decoder wheel. No system Python, no pip, and no online update checks.
Windows v1.0.7 (x64) and Linux v1.0.7 (x64) releases are published with direct artifacts and SHA-256 checksums verified against each live release.
Inside the Workbench
Nine workspaces are documented for the live v1.0.7 (Windows/Linux) releases: Code Explorer · Decoder Lab · Benchmark · Batch & Streaming · Hardware · Diagnostics · Documentation · Lab & Personal Info · Console.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Explore this workspace with the release documentation and inspect results on your own machine. No hardware-specific run data is published here.
Downloads
Windows x64 · v1.0.7
Portable single executable and release ZIP. No installer required, no admin rights. The app makes no online update checks.
- Published 2026-09-04 in the verified GitHub release.
- Download
QectorWorkbench-Portable.exe, then launch directly. - Headless MCP server:
QectorWorkbench-Portable.exe --mcp - Runtime data:
%LOCALAPPDATA%\QectorWorkbench - Exe SHA-256:
c53ca5f4fc49152f242a847d0ca11f147164dda426ae29ec170c451871b8ab13
Linux x64 · v1.0.7
Published v1.0.7 portable ELF executable and Debian (.deb) package with bundled qector-decoder-v3 1.0.0 backend and 85-tool MCP server.
- Published 2026-09-04 in the verified GitHub release.
- Download
QectorWorkbench-Portableor the Debian package. - Headless MCP server: append
--mcp - Runtime data:
~/.local/share/QectorWorkbench - Portable SHA-256:
aa3949d25082165dc3b89115486e1ea4e210cd5254659da32185fe6a8e71a1c8 - Debian SHA-256:
5221dc9557319f2c55e6048ab30eb4a080d603abc9bab3d2b4cde01ef5b8aa45
macOS arm64 - not ready yet
Apple silicon build requires a build on Apple hardware and is not included until that build is produced and signed.
- Requires Apple hardware build - coming soon
- No artifact yet - check back for macOS release
- Windows and Linux v1.0.7 are live with 19 decoders
QECTOR_DATA_DIR.Integrated Decoders
All 19 named kinds (17 concrete configurations plus AutoDecoder and Auto Router) are exposed through the Workbench MCP server. No benchmark figures are published on the site: run the included harness to measure your own hardware.
Each v1.0.7 release (Windows/Linux) declares 19 named kinds: 17 concrete configurations plus 2 orchestration entries against its bundled qector_decoder_v3 1.0.0 backend. Consult each release's included manuals for platform-specific coverage.
| Decoder Kind | Compatibility | Description |
|---|---|---|
| union_find | Graphlike | Fast approximate Union-Find decoding; higher LER than exact MWPM. |
| fast_union_find | Graphlike | Optimized Union-Find hot path; approximate. |
| blossom | Graphlike | Weight-optimal exact minimum-weight perfect matching (Edmonds' Blossom). |
| sparse_blossom | Graphlike | Event-driven Sparse Blossom with radix-heap region growth; near-optimal in its tested scope. |
| bp_osd | Universal / qLDPC | Belief propagation + ordered-statistics decoding for LDPC / qLDPC codes. |
| auto | Graphlike | Self-selecting AutoDecoder: picks the best available decoder for the code. |
| hybrid | Graphlike | Combines a fast heuristic pass with exact matching. |
| lookup_table | Small (<20 checks) | Precomputed syndrome-to-correction table with O(1) lookup. |
| predecoded | Graphlike | Fast pre-decoding pass that resolves easy/low-weight syndromes. |
| auto_router | Universal | Policy decoder: inspects the code and dispatches the best concrete decoder. |
| hybrid_cascade | Graphlike | Union-Find pre-filter escalating to Blossom/BP-OSD. |
| gnn_belief_matching | Graphlike | GNN-predicted per-qubit weights guide edge-weighted matching with fallback. |
| belief_matching | Universal | Sum-product BP posteriors reweight an exact Blossom matching. |
| two_stage | Graphlike | Decoupled X/Z sector decoders for CSS / colour codes. |
| ambiguity_cluster | qLDPC | Cluster-growth decoder for high noise or non-graphlike codes. |
| colour_code | Universal / qLDPC | BP-OSD hypergraph decoder over undecomposed detector error models. |
| space_time | Lifted graphlike | Space-time decoder for multi-round decoding (experimental). |
| spacetime_mwpm | Multi-round | Space-time MWPM for phenomenological & circuit-level decoding. |
| soft_llr | Soft-decision | Log-likelihood-ratio-weighted decoding. |
10 Supported Code Families
The published releases cover 10 code families, including qLDPC and colour codes.
1D chain parity-check code.
Periodic 1D chain.
Standard rotated surface code.
Square lattice surface code.
Toric code with periodic boundaries.
Heavy-hex lattice.
CSS code from repetition seed.
qLDPC bicycle code.
Bivariate bicycle presets (qLDPC).
Triangular & 2D 4.8.8 colour codes.
Workbench Components
Desktop GUI
CustomTkinter desktop UI for Windows and Linux. Visual circuit builder, syndrome viewer, decoder performance dashboard, and a distance slider covering d3-d63 on supported families.
MCP Tools
Native Model Context Protocol server over stdio JSON-RPC 2.0, launched with --mcp and usable headlessly with no display. Connects AI agents directly to decoder execution and diagnostics.
Self-Contained
Bundles its own Python runtime, the scientific stack, and the qector_decoder_v3 1.0.0 wheel. No system Python or pip required; the app makes no online update checks.
Self / Auto-Debug Layer
Verifies H·c == s on every decode with a full attempt trace, and falls back across decoders automatically when a decoder fails to produce a faithful correction.
Hardware Dashboard
Auto-detects CUDA, OpenCL, and CPU backends, and reports OpenCL absence honestly: it names why a backend is unavailable rather than printing a bare N/A.
Lab & Personal Info
Deposit profile (author, ORCID, affiliation, DOI, funding, keywords) for generated reports, plus decoder license-key installation with a live tier readout.
Documentation Export
Export documentation and evidence in the formats supported by the selected release, with optional .zenodo.json and CITATION.cff deposit sidecars.
Bundled Manuals & EULA
Each release ships an API Reference, MCP Integration Guide, Quick Start Guide, a per-OS User Manual, a machine-readable LLM manual, and EULA.txt, with SHA-256 checksums for every file.
Decoder Sandbox
Below is an interactive sandbox replicating the basic topological planar code matching module inside QECTOR Workbench. Click to inject errors and inspect Blossom correction paths in real time.
Interactive QEC Simulator
Planar stabilizer code (d=3). Click edges to toggle physical errors.
QECTOR Workbench documentation is published alongside each app release. The Windows v1.0.7 and Linux v1.0.7 builds ship per-OS manuals and SHA-256 checksums; use the release-specific manuals for your platform.