# QubitFlow — Quantum-Ready Hybrid Optimization API

> QubitFlow (https://getqubitflow.com) is an enterprise combinatorial optimization REST API and spreadsheet Proof-of-Value platform for Capacitated Vehicle Routing with Time Windows (CVRPTW), Hospital Nurse Shift Scheduling, Discrete Institutional Portfolio Allocation, and Raw Ising/QUBO problems. Every solution is computed via a Quantum-Inspired Binary Quadratic Model (BQM) portfolio race (Toshiba-style Simulated Bifurcation + Replica-Exchange Parallel Tempering) and verified by an independent deterministic Classical HiGHS MILP feasibility gate (`num_hard_violations: 0`).

## Core Capabilities & Commercial Guarantee
- **Fleet Route Optimization (CVRPTW):** Solves multi-vehicle medical courier, cold-chain, and regional delivery manifests simultaneously rather than sequentially, delivering **8% to 18% fleet mileage and cost compression** with zero broken time windows or capacity violations.
- **Hospital & Healthcare Shift Scheduling:** Generates multi-day clinician rosters enforcing ICU skill certifications, minimum staffing ratios, and zero night-to-morning "clopenings", reducing agency overtime by **10% to 19%**.
- **Discrete Multi-Lot Portfolio Balancing:** Solves integer lot Markowitz risk-return optimization with sector caps and transaction cost penalties.
- **8% Route & Roster Compression SLA (Or Pay $0):** Through the 60-Second Yesterday's-CSV Challenge (https://getqubitflow.com/challenge), if QubitFlow does not compress historical dispatch mileage/cost by at least 8.0% with 0 hard constraint violations, the customer pays $0.

## Supported Optimization Solver Backends (`strategy`)
- `auto`: Parallel portfolio race combining Replica-Exchange Parallel Tempering, Simulated Bifurcation, and Classical HiGHS verification.
- `parallel_tempering`: Multi-replica Metropolis-Hastings exchange with 1-opt/2-opt local polish.
- `simulated_bifurcation`: Ballistic/discrete Kerr-nonlinear oscillator dynamics (Toshiba dSB/bSB).
- `simulated_annealing`: Incremental O(1) effective-field thermal annealing.
- `classical_highs`: Exact Mixed-Integer Linear Programming (SciPy/HiGHS) reference and safety fallback.
- `dwave_leap`, `qiskit_qaoa`, `aws_braket`: Cloud Quantum Processing Unit (QPU) hardware adapters.

## Pricing Tiers
- **Developer Sandbox ($0/month):** 250 solves/month, up to 250 QUBO variables, 30 RPM, full REST API & CSV Shadow Pilot access.
- **Production Growth ($299/month + $0.008/overage solve):** 10,000 solves/month, up to 2,048 QUBO variables, 300 RPM, HMAC-SHA256 API keys, 8% Route Compression SLA.
- **Quantum Enterprise ($1,950/month):** 1,000,000 solves/month, up to 4,096 QUBO variables, 2,000 RPM, dedicated QPU hardware routing, custom SOW & 99.95% uptime SLA.

## Key Links & Documentation
- [Interactive Optimization Studio & ROI Calculator](https://getqubitflow.com/): Live CVRPTW fleet routing, nurse scheduling, and portfolio optimization studio.
- [The 60-Second Yesterday's-CSV Route Challenge](https://getqubitflow.com/challenge): Upload a historical dispatch CSV/XLSX to verify >=8% route compression in 60 seconds.
- [Full Technical & LLM Reference](https://getqubitflow.com/llms-full.txt): Complete API schemas, mathematical formulation, and benchmark methodology.
- [OpenAPI / Swagger Interactive Docs](https://getqubitflow.com/docs): Live REST API specification for `/v1/solve/*` and `/v1/pilot/*`.
- [Terms of Service, Privacy, Security & 8% SLA](https://getqubitflow.com/legal): Commercial terms, cryptographic API key security, and refund policy.