This release is a pre-release and may not be stable for production use.
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 ParallelSimulator
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=ParallelSimulator(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 ParallelSimulator 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: ParallelSimulator, 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.
2 maintainers
Metadata
2 maintainers
Release files for qoro-divi 0.8.0.dev20260311
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qoro_divi-0.8.0.dev20260311.tar.gz | 153.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qoro_divi-0.8.0.dev20260311-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 346.1 kB
Release files / qoro_divi-0.8.0.dev20260311.tar.gz
| Download URL | qoro_divi-0.8.0.dev20260311.tar.gz |
|---|---|
| Size | 153.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f20b8185493749136f6883325f15a4315f9bfcb638ae7398b70a7e8d2d63128b
|
|
BLAKE2b-256 checksum How to use checksums |
770c305ee328e08843bb7cb2768701178c9cc007036bd9a1057ad02200c34a8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.11.14 Linux/6.14.0-1017-azure
|
Release files / qoro_divi-0.8.0.dev20260311-py3-none-any.whl
| Download URL | qoro_divi-0.8.0.dev20260311-py3-none-any.whl |
|---|---|
| Size | 192.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
55b565f24e00454be0e2ce35e746d4290052fe3fd058e7821e2d12f679acff24
|
|
BLAKE2b-256 checksum How to use checksums |
a382aea559c6674763f90e3cd32ab48eb4a2982a672a8d006f3bf2f0a2bfdba6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.11.14 Linux/6.14.0-1017-azure
|
