Divi Documentation

Divi is a Python library for building and running quantum programs at scale. It sits above circuit-level frameworks like PennyLane and Qiskit and handles the orchestration that practitioners usually write by hand: circuit generation, batching, error mitigation, parameter optimisation, and result aggregation.

Why Divi?

  • Batteries-included algorithms — ready-to-run VQE for chemistry, QAOA / PCE for combinatorial optimisation, TimeEvolution for dynamics, and QNN for quantum machine learning — or bring your own circuit with CustomVQA.

  • Structured pipelines — an expand → execute → reduce model automates the path from a high-level program to executed circuits, with inspectable stages for compilation, batching, and error mitigation. See Pipelines.

  • Program ensembles — run many variational programs in parallel under one ProgramEnsemble, optionally over multiple adaptive rounds where each round’s programs are chosen from what the last round measured, with automatic circuit batching and aggregation. Built-in workflows cover hyperparameter sweeps, graph partitioning, and time-evolution trajectories. See Program Ensembles and Workflows.

  • Swap backends without changing code — develop and simulate locally with MaestroSimulator, use QiskitSimulator for Qiskit-native or device-calibrated noise models, and scale up on the cloud via QoroService — all behind the same CircuitRunner interface. See Backends.

  • Integrated error mitigation — Zero-Noise Extrapolation and QuEPP plug directly into the variational loop, not as a post-processing step. See Improving Results with Error Mitigation.

New to Divi? Start with the Quick Start Guide for a five-minute VQE example and a tour of the built-in algorithms, then explore Algorithms or Execution & Workflows in the sidebar.

Installation

uv add qoro-divi     # or: pip install qoro-divi

That covers local and cloud execution, VQE, QAOA, and program ensembles. Heavier features — Qiskit Aer backends, partitioned QUBO solving, chemistry, and the divi-ai assistant — live behind optional extras. See Installation for the full list, what each one unlocks, and what keeps working without it.

Algorithms

Execution & Workflows

Tools

API Reference

Development

Indices and tables