OriginQ (Wukong)¶

Run benchmarks on OriginQ Wukong superconducting quantum computers.

Prerequisites¶

An OriginQ QCloud account
OriginQ API token
(macOS only) libidn2 library

Setup¶

1. Get Your API Token¶

Log in to the OriginQ Workbench
Navigate to your account settings
Copy your API token

2. Configure Environment¶

Add to your .env file:

ORIGIN_API_KEY="<your-origin-api-token>"

3. macOS Setup¶

macOS users must install libidn2 before using the OriginQ provider:

brew reinstall libidn2

Install this library before running uv sync or installing Metriq-Gym to avoid missing symbol errors during the pyqpanda3 build.

Discovering Devices¶

To see currently available devices:

from qbraid.runtime import load_provider

provider = load_provider("origin")
for device in provider.get_devices():
    print(f"{device.id}: {device.status}")

OriginQ offers both hardware (including the Wukong quantum computer) and various simulators.

Usage¶

Dispatch to Wukong Hardware¶

# Wukong 72-qubit device
mgym job dispatch metriq_gym/schemas/examples/wit.example.json \
    --provider origin --device wukong_72

# Wukong 102-qubit device
mgym job dispatch metriq_gym/schemas/examples/wit.example.json \
    --provider origin --device wukong_102

Dispatch to OriginQ Simulator¶

mgym job dispatch metriq_gym/schemas/examples/wit.example.json \
    --provider origin --device full_amplitude

Poll Results¶

mgym job poll <JOB_ID>

Troubleshooting¶

"resource is null" Error¶

This error indicates: - The device name is incorrect - Your account lacks permission for the requested device

Verify available devices with the listing command above.

Missing libidn2 (macOS)¶

If you see symbol errors related to pyqpanda3:

# Install the library
brew reinstall libidn2

# Reinstall metriq-gym
pip install --force-reinstall metriq-gym

Authentication Errors¶

Verify your API token is correctly set:

import os
print(os.environ.get("ORIGIN_API_KEY"))

Connection Issues¶

OriginQ services are based in China. Connection latency or timeouts may occur from other regions. Consider: - Retrying failed requests - Using longer timeout values - Running during off-peak hours

Device Topology¶

Wukong devices use a 2D grid topology. For topology-dependent benchmarks (BSEQ, Mirror Circuits), the provider automatically retrieves connectivity information.

from metriq_gym.run import load_provider

provider = load_provider('origin')
device = provider.get_device('wukong_72')
# Topology available via device.metadata