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 optimization, and result aggregation.

Why Divi?

  • Batteries-included algorithms — ready-to-run VQE for chemistry, QAOA / PCE for combinatorial optimization, 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, 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 locally against MaestroSimulator, simulate noise with QiskitSimulator, and scale up on the cloud via QoroService — all behind the same CircuitRunner interface. See Backends Guide.

  • 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 work through the User Guide in the sidebar.

Installation

Divi can be installed using uv (recommended) or pip.

If you have uv installed:

uv add qoro-divi

Or if you want to install from source:

git clone https://github.com/QoroQuantum/divi.git
cd divi
uv sync

Alternatively, you can install using pip:

pip install qoro-divi

Nightly Builds

Nightly development builds are published daily from main. To install the latest nightly:

pip install qoro-divi --pre

Or pin a specific nightly by date:

pip install qoro-divi==0.8.0.dev20260305

Note

Nightly builds may contain unstable or experimental features. For production use, stick with the stable release (pip install qoro-divi).

User Guide

Tools

API Reference

Development

Indices and tables