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.
[!TIP] Using Claude Code, Cursor, or another LLM coding agent? Divi is indexed on Context7 — point your agent at
/qoroquantum/divito pull current, version-specific Divi docs and snippets directly into its context.
⚡ At-Scale Example
For the shortest introduction, start with the five-minute tutorial.
pip install qoro-divi
That covers local and cloud execution, VQE, QAOA, and program ensembles.
Heavier features live behind optional extras — aer (Qiskit Aer backends),
qubo-decompose (partitioned QUBO solving), chem (PySCF/OpenFermion
chemistry), ai, and jupyter — or pip install "qoro-divi[all]" for
everything. See the
installation guide
for what each unlocks and what keeps working without it.
Nightly Builds
To install the latest development build (published daily from main):
pip install qoro-divi --pre
Split a graph into quantum-sized MaxCut problems, solve the partitions, and stitch their candidates into a global solution:
import networkx as nx
from divi.backends import MaestroSimulator
from divi.qprog import BeamSearchStrategy
from divi.qprog.optimizers import ScipyOptimizer, ScipyMethod
from divi.qprog.problems import GraphPartitioningConfig, MaxCutProblem
from divi.qprog.workflows import PartitioningProgramEnsemble
graph = nx.barbell_graph(4, 0)
problem = MaxCutProblem(
graph,
config=GraphPartitioningConfig(
max_n_nodes_per_cluster=4,
partitioning_algorithm="kernighan_lin",
),
)
backend = MaestroSimulator()
ensemble = PartitioningProgramEnsemble(
problem=problem,
n_layers=1,
backend=backend,
optimizer=ScipyOptimizer(method=ScipyMethod.COBYLA),
max_iterations=10,
seed=42,
)
ensemble.run()
cut, _ = ensemble.aggregate_results(
strategy=BeamSearchStrategy(beam_width=3, n_partition_candidates=5)
)
print(f"Cut edges: {nx.cut_size(graph, cut)}")
print(f"Circuits executed: {ensemble.total_circuit_count}")
PartitioningProgramEnsemble handles decomposition, parallel execution, and
candidate aggregation while each partition remains small enough for the chosen
backend.
🌐 Cloud Execution with Qoro Service
Run the same workflow on Qoro's cloud platform by swapping only the backend:
from divi.backends import QoroService
backend = QoroService() # reads QORO_API_KEY from .env or environment
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.
🤖 divi-ai: AI Coding Assistant
Ask questions about Divi directly in your terminal — no API keys, no internet required after setup.
pip install qoro-divi[ai]
divi-ai
Answers questions about Divi APIs, generates code examples, and explains concepts — powered by a local LLM that runs entirely on your machine. See the full documentation for model options and usage.
🧩 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 Ensembles | Parallel execution of multiple quantum programs with automatic scheduling, over one round or many adaptive ones |
| Flexible Backends | MaestroSimulator for local simulation, QiskitSimulator for Qiskit-native noise models (extra: aer), QoroService for cloud execution |
| 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: MaestroSimulator, QiskitSimulator (extra: aer), QoroService
├── circuits/ # MetaCircuit templates and Circuit instances
├── pipeline/ # Circuit pipeline stages (expand, execute, reduce)
├── hamiltonians # Molecular Hamiltonian generation
├── reporting/ # Live reporting and visualization callbacks
└── ai/ # Offline documentation chatbot (divi-ai)
📚 Documentation
Algorithm guides, execution guides, and API reference: divi.readthedocs.io
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
Release files for qoro-divi 0.14.0.dev20260827
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.14.0.dev20260827.tar.gz | 19.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qoro_divi-0.14.0.dev20260827-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 39.0 MB
Release files / qoro_divi-0.14.0.dev20260827.tar.gz
| Download URL | qoro_divi-0.14.0.dev20260827.tar.gz |
|---|---|
| Size | 19.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1165e1ebd3b8f52316ad668268a65cdd5dd1192c03ec3abc5f53d3875da28165
|
|
BLAKE2b-256 checksum How to use checksums |
c6896726827b9df9e5d69a8f89c5d269baf4e99d7cd06dc944b326552aa74643
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency logRelease files / qoro_divi-0.14.0.dev20260827-py3-none-any.whl
| Download URL | qoro_divi-0.14.0.dev20260827-py3-none-any.whl |
|---|---|
| Size | 19.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
70f0472d031397bbf5447921980628f095f89ff76362feadb63bb2772df6057b
|
|
BLAKE2b-256 checksum How to use checksums |
6517947868d11c3e0e94704b8fa21d88242c67ad42c334dccb14f13200b423db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency log
