Metadata-Version: 2.4
Name: jiuzhang-sdk
Version: 0.1.0a17
Summary: 九章光量子真机云接入软件包（jiuzhang SDK）
Author: 九章量子 SDK 团队
License: Proprietary
Keywords: gbs,jiuzhang,photonic,quantum,sdk
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.12
Requires-Dist: httpx<0.29,>=0.27
Requires-Dist: numpy>=1.26
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest-mock>=3; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Provides-Extra: jupyter
Requires-Dist: ipython>=8; extra == 'jupyter'
Description-Content-Type: text/markdown

# 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 / 瀹夎

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

## Required Task Fields / 蹇呭～浠诲姟瀛楁

GBS submissions require `project_id` and `quantum_computer_id`.

GBS submissions use `project_id` and `quantum_computer_id`.
```python
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",
    quantum_computer_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`銆?
```text
POST /estimate
POST /tasks/submit
GET  /tasks/{task_id}
```

## Environment / 鐜鍙橀噺

```powershell
$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_QUANTUM_COMPUTER_ID="PH_QC_04"
```

## Local Mock / 鏈湴 Mock

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

## Test / 娴嬭瘯

```powershell
ruff format src tests
ruff check src tests
mypy src
pytest
```

## License / 鎺堟潈

Proprietary. Copyright 漏 2026 JiuZhang Quantum.
