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.
⚡ 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.9.0.dev20260312
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.dev20260312.tar.gz | 155.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qoro_divi-0.9.0.dev20260312-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 350.7 kB
Release files / qoro_divi-0.9.0.dev20260312.tar.gz
| Download URL | qoro_divi-0.9.0.dev20260312.tar.gz |
|---|---|
| Size | 155.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
44a793d99e946068787e1684ab9a2b53553252d70749d0252252cfb2b6f3b522
|
|
BLAKE2b-256 checksum How to use checksums |
df929a90dec227a3eec8882d77397050b706f7fc1f0bbe533ed7de3c79a4f38e
|
| 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.9.0.dev20260312-py3-none-any.whl
| Download URL | qoro_divi-0.9.0.dev20260312-py3-none-any.whl |
|---|---|
| Size | 195.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c9e5831f1656be6821b3db7e454d908ef66a8cafe000ab1920a4a33f7caed79
|
|
BLAKE2b-256 checksum How to use checksums |
438d59c1e6be63738b3329da07edf27b92b02aa42d775435e8659d2112d93532
|
| 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
|
