Divi
Cloud Simulation

Cloud Simulation

QoroService connects Divi to Qoro’s cloud simulation platform, where jobs are routed to high-performance Maestro simulator backends — including MPS, state vector, and stabilizer simulators.

This is ideal for:

  • Large circuits that are too slow for local simulation
  • Running on high-performance cloud simulators
  • Parallelizing workloads across cloud instances
  • Scaling variational algorithms to larger problem sizes

Getting Started

1. Create an Account & Get Your API Token

Visit dash.qoroquantum.net to create an account and manage your API tokens. From the dashboard you can:

  • Generate your API token — head to the Token page to activate your token
  • Purchase simulation credits — browse available credit packages on the Credits page
  • Monitor your jobs — track submitted jobs, credit usage, and execution history

2. Install Divi 

pip install qoro-divi

3. Configure Your Token

Store your API token in a .env file at the root of your project:

# .env
QORO_API_KEY="your-api-token"

⚠️ Important: Make sure .env is listed in your .gitignore so you don’t accidentally commit your API key to version control.

Cloud Examples

Divi supports running a wide range of quantum programs on the cloud via QoroService, including:

  • Cloud VQE — Variational Quantum Eigensolver for molecular ground-state energy estimation
  • Cloud QAOA — Combinatorial optimization problems like MaxCut
  • Cloud VQE Sweep — Sweep across molecular bond lengths to map out potential energy surfaces
  • Cloud Custom VQA — Custom variational quantum algorithms with your own parameterized circuits

Features

Expectation Value Support

When using QoroService with the qoro_maestro system, expectation values of your cost Hamiltonian are computed directly on the cloud backend. Instead of sampling bitstrings locally and reconstructing expectation values, Divi sends the Hamiltonian as Pauli operator strings to the cloud, where they are evaluated efficiently. This avoids the overhead of observable grouping and state tomography.

This is enabled automatically for all variational algorithms (VQE, QAOA, CustomVQA, etc.) when the backend supports it. You can also use it directly via submit_circuits by providing your QASM circuit and observables as semicolon-separated Pauli strings.

If you need to force sampling-based measurement instead, set force_sampling=True when initializing QoroService.

Checkpointing

Save and resume long-running cloud jobs. If a cloud execution is interrupted, checkpointing lets you pick up exactly where you left off. See the Checkpointing page for details.

📖 For code examples and detailed API usage, visit the Divi Documentation.

Local SimulationVQE