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 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.
2 maintainers
Metadata
2 maintainers
Release files for qoro-divi 0.9.0.dev20260323
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.9.0.dev20260323.tar.gz | 163.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qoro_divi-0.9.0.dev20260323-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 368.5 kB
Release files / qoro_divi-0.9.0.dev20260323.tar.gz
| Download URL | qoro_divi-0.9.0.dev20260323.tar.gz |
|---|---|
| Size | 163.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6a39c3cc70a173f743df2f9a2e3a6c498f070c6494e9f06284a91b0e030eb833
|
|
BLAKE2b-256 checksum How to use checksums |
f2a99d12e0cf8eb9432347c081f91ae28adf58d32621f0636a6d20cc3a1c3b01
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.11.15 Linux/6.14.0-1017-azure
|
Release files / qoro_divi-0.9.0.dev20260323-py3-none-any.whl
| Download URL | qoro_divi-0.9.0.dev20260323-py3-none-any.whl |
|---|---|
| Size | 205.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
000a3ae555db966e5d7b9243e02e0e0a7ac1b90ff4393f9a11b79170dfe3e407
|
|
BLAKE2b-256 checksum How to use checksums |
84984b6faec071464de2820a19df2a40e92d58e21e58ca06281eb2f7933b0c66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.11.15 Linux/6.14.0-1017-azure
|
