Pre-release

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/divi to 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

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, `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, 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qoro_divi-0.14.0.dev20260822.tar.gz (19.6 MB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

qoro_divi-0.14.0.dev20260822-py3-none-any.whl (18.8 MB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file qoro_divi-0.14.0.dev20260822.tar.gz.

File metadata

Download URL: qoro_divi-0.14.0.dev20260822.tar.gz
Upload date: Aug 22, 2026
Size: 19.6 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qoro_divi-0.14.0.dev20260822.tar.gz
Algorithm	Hash digest
SHA256	`c53ca9fbe11e26de9abad9c67feb838a6f2dbd6cace680f08bc75afbc8373d26`
MD5	`da11b7be1e2429170f205a8b12f1ec97`
BLAKE2b-256	`c8089ccfd5401620864375d0ba6c5d187a5272caaae2d8bffed91294cafbb9c1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qoro_divi-0.14.0.dev20260822.tar.gz:

Publisher: nightly.yml on QoroQuantum/divi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qoro_divi-0.14.0.dev20260822.tar.gz
- Subject digest: c53ca9fbe11e26de9abad9c67feb838a6f2dbd6cace680f08bc75afbc8373d26
- Sigstore transparency entry: 2556215811
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: QoroQuantum/divi@faed8a02986bca4bc3e4bbd093db12d85e8c9502
- Branch / Tag: refs/heads/main
- Owner: https://github.com/QoroQuantum
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: nightly.yml@faed8a02986bca4bc3e4bbd093db12d85e8c9502
- Trigger Event: schedule