WestQuant QCSC Optimizer

Use the QPU only where the QPU is actually needed.

An open-source, software-agnostic analyzer and optimizer for hybrid quantum-classical projects. The system inspects a user's quantum codebase and answers:

Which planned quantum operations actually need QPU hardware?

Core distinction

Existing hybrid quantum systems often solve: Where should task T execute?

WestQuant solves the deeper problem: Should task T require a QPU at all?

This is Semantic QPU Minimization.

V0.1 — Advisory Only

V0.1 performs static analysis + cost estimation + recommendations. It does NOT:

• modify user code
• execute user code
• submit jobs to hardware
• automatically rewrite experiments

Quick Start

# Install
pip install -e .

# Audit a project
westquant audit ./my_quantum_project

# Specify output directory
westquant audit ./my_quantum_project -o ./reports

Output

westquant_report.html    # Full HTML report
westquant_report.md      # Markdown report
westquant_plan.json      # Machine-readable plan (SAFE/BALANCED/AGGRESSIVE)
westquant_workflow.json  # WQFlow IR graph

What It Detects

Three Plans

• SAFE: Only EXACT transformations. Mathematical result preserved.
• BALANCED: EXACT + EQUIVALENT + low-risk APPROXIMATE. Requires tolerance ε.
• AGGRESSIVE: All transformations including EXPERIMENTAL. Always shows uncertainty.

Architecture

qcsc/
├── flow_ir/              # WQFlow IR — directed graph of hybrid workflows
├── resource_model/       # QPU backend + local compute capabilities
├── transformation_registry/  # 15 QPU-saving transformations (T01-T15)
├── analyzer/             # Framework-specific source analysis (Qiskit first)
├── detectors/            # Detectors that produce recommendations
├── planner/              # Pareto planner (SAFE/BALANCED/AGGRESSIVE)
├── reporting/            # HTML + Markdown + JSON report generation
├── benchmark/            # Benchmark projects with known opportunities
├── experiments/          # Validation experiment protocols
├── rfc/                  # RFC specifications
└── tests/                # Test suite

Design Philosophy

WestQuant asks three questions in order:

1. Does this operation need to happen?
2. Does it need to be quantum?
3. Only then: which resource should execute it?

That ordering is the defining idea of the project.

License

MIT