jiuzhang-sdk 0.1.0a14

九章光量子真机云接入软件包（jiuzhang SDK）

jiuzhang SDK · 九章光量子云平台 Python SDK

This code/ directory contains the Python package source for jiuzhang-sdk. The SDK talks to the JiuZhang cloud API only; Tianyan is reached by the cloud platform backend.

本 code/ 目录是 jiuzhang-sdk 的 Python 源码工程。SDK 只调用九章云平台 API； 天衍平台由云平台后台转发。

Install / 安装

pip install --pre jiuzhang-sdk
pip install jiuzhang-sdk==0.1.0a14
pip install -e ".[dev,jupyter]"

Required Task Fields / 必填任务字段

GBS submissions require project_id and device_id.

GBS 任务提交必须带 project_id 与 device_id。

from jiuzhang import CloudClient, GBSParams

client = CloudClient(
    base_url="http://127.0.0.1:18081/api/v1",
    api_key="PQ-3f2c2a3b0f7a4a2ab1cdb0b7d2f1a9c4",
)

params = GBSParams(
    project_id="EXP-local-demo",
    device_id="PH_QC_04",
    mt=64,
    pump_energy_nj=2.0,
    squeezing_param=0.35,
)

result = client.run_gbs(params)

API Paths / API 路径

base_url may include /api/v1.

base_url 可以包含 /api/v1。

POST /estimate
POST /tasks/submit
GET  /tasks/{task_id}

Environment / 环境变量

$env:JIUZHANG_API_KEY="your_api_key"
$env:JIUZHANG_BASE_URL="http://127.0.0.1:18081/api/v1"
$env:JIUZHANG_PROJECT_ID="EXP-local-demo"
$env:JIUZHANG_DEVICE_ID="PH_QC_04"

Local Mock / 本地 Mock

python ..\local_test\mock_cloud_platform\mock_cloud_platform.py --port 18081 --mode standalone

Test / 测试

ruff format src tests
ruff check src tests
mypy src
pytest

License / 授权

Proprietary. Copyright © 2026 JiuZhang Quantum.