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.dev20260310
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.dev20260310.tar.gz | 144.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qoro_divi-0.8.0.dev20260310-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 328.3 kB
Release files / qoro_divi-0.8.0.dev20260310.tar.gz
| Download URL | qoro_divi-0.8.0.dev20260310.tar.gz |
|---|---|
| Size | 144.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e1ab0ff6beed580b8bfba4e410db8fb2a96793d5476eeb56b4454b083bff5bfb
|
|
BLAKE2b-256 checksum How to use checksums |
fcb92e071ed0fff5299ca8cb50747f06151b4d77a26633eec7459af8b72f1991
|
| 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.dev20260310-py3-none-any.whl
| Download URL | qoro_divi-0.8.0.dev20260310-py3-none-any.whl |
|---|---|
| Size | 183.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0a7d1e229e1136a5ea9c16faaf8120dbc88290e486dc4b459517fe7a1bfc806e
|
|
BLAKE2b-256 checksum How to use checksums |
f382fdaa0980b56155c8de8498d3effe4b3fabfe518980953b9dbf923f4bc948
|
| 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
|
