qoro-divi 0.9.0.dev20260327

A Python library to automate generating, parallelizing, and executing quantum programs.

Divi

Generate, parallelize, and execute quantum programs at scale.

---

Divi is a Python library by Qoro Quantum for building and running quantum programs at scale. It handles circuit generation, job parallelization, and cloud execution — with built-in support for variational algorithms, custom workflows, and more — so you can focus on the quantum problem, not the plumbing.

[!IMPORTANT] Divi is under active development. Expect breaking changes between minor versions.

⚡ Quick Start

pip install qoro-divi

Nightly Builds

To install the latest development build (published daily from main):

pip install qoro-divi --pre

Run a VQE energy minimization in a few lines:

import numpy as np
import pennylane as qml
from divi.qprog import VQE, HartreeFockAnsatz
from divi.backends import QiskitSimulator
from divi.qprog.optimizers import ScipyOptimizer, ScipyMethod

# Define an H₂ molecule
molecule = qml.qchem.Molecule(
    symbols=["H", "H"],
    coordinates=np.array([(0, 0, 0), (0, 0, 0.5)]),
)

vqe = VQE(
    molecule=molecule,
    ansatz=HartreeFockAnsatz(),
    n_layers=2,
    backend=QiskitSimulator(shots=5000),
    optimizer=ScipyOptimizer(method=ScipyMethod.COBYLA),
    seed=42,
)

vqe.run()
print(f"Ground state energy: {vqe.best_loss:.6f}")

🌐 Cloud Execution with Qoro Service

Run the same programs on Qoro's cloud platform with tensor-network simulators — no code changes needed:

from divi.backends import QoroService

service = QoroService()  # reads QORO_API_KEY from .env or environment
vqe = VQE(molecule=molecule, backend=service)
vqe.run()

Get started for free → Sign up at dash.qoroquantum.net and receive $100 worth of credits to run your first quantum programs on our cloud.

🧩 Key Features

Feature	Description
VQE & QAOA	Built-in variational algorithms with pluggable ansätze and optimizers
Circuit Pipelines	Expand → execute → reduce pattern for complex circuit workflows
Program Batching	Automatic Pauli grouping, circuit packing, and parallel execution
Dual Backends	Local QiskitSimulator for dev, QoroService for cloud production
Execution Config	Control bond dimension, simulator type, and simulation method per job
Live Reporting	Real-time dashboards and convergence tracking via callbacks

🏗️ Architecture

divi/
├── qprog/        # Quantum programs: VQE, QAOA, base classes, optimizers
├── backends/     # Execution backends: QiskitSimulator, QoroService
├── circuits/     # MetaCircuit templates and Circuit instances
├── pipeline/     # Circuit pipeline stages (expand, execute, reduce)
├── hamiltonians  # Molecular Hamiltonian generation
└── reporting/    # Live reporting and visualization callbacks

📚 Documentation

Full documentation, user guides, and API reference: docs.qoroquantum.net/divi

Hands-on examples are in the tutorials/ folder.

� Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup, testing, and code style guidelines.

📄 License

Apache 2.0 — see LICENSE for details.