jiuzhang-sdk 0.1.0a15

九章光量子真机云接入软件包（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 婧愮爜宸ョ▼銆係DK 鍙皟鐢ㄤ節绔犱簯骞冲彴 API锛?澶╄骞冲彴鐢变簯骞冲彴鍚庡彴杞彂銆?

Install / 瀹夎

pip install --pre jiuzhang-sdk
pip install jiuzhang-sdk==0.1.0a15
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.