# 安装 SDK

使用 Python 3.12。当前下载包为 0.4.14+20261027.simcompat。

## 使用当前版本安装包

- [下载 SDK 0.4.13 wheel（本地构建）](../../sdk/quantum_source_sdk-0.4.14+20261027.simcompat-py3-none-any.whl)
- [SHA 256 校验清单](../../sdk/SHA256SUMS.txt)

把 wheel 下载到当前项目目录，然后在 PowerShell 执行以下命令，创建 Python 环境并安装 SDK。

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "./quantum_source_sdk-0.4.14+20261027.simcompat-py3-none-any.whl[all,secure]"
.\.venv\Scripts\python.exe -m pip install ipykernel
```

只使用 Qiskit 时把 [all,secure] 换成 [qiskit,secure]；只使用 PennyLane 时换成 [pennylane,secure]；仅 Core 可使用 [secure]。secure 是可选依赖组，用于安装 keyring，以便将平台凭据保存到系统密钥库。若不使用账号保存功能，可省略 secure；它不影响设备功能或任务提交。

## 使用当前本地源码

当前 0.4.14+20261027.simcompat 支持客户端级 OPEN/FULL 钱包选择，以及等待时间、查询间隔和进度显示设置。使用源码安装时，在本项目 sdk 文件夹中执行下面的命令。源码安装和 wheel 安装任选一种。

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install ".[all,secure]"
.\.venv\Scripts\python.exe -m pip install ipykernel
```

## 确认 Notebook 使用正确环境

在 PyCharm 的项目解释器和 Notebook 内核中选择刚安装 SDK 的 .venv/Scripts/python.exe。运行下面的代码可查看解释器路径和 SDK 版本。

```python
import sys
from quantum_source_sdk import __version__

print(sys.executable)
print(__version__)
```

| 依赖 | 当前包声明 |
| --- | --- |
| Python | >=3.12,<3.13 |
| Qiskit 可选依赖 | >=2.0,<3 |
| PennyLane 可选依赖 | >=0.45.1,<0.46 |
| NumPy 框架依赖 | >=1.26,<3 |
| 系统密钥库可选依赖 | keyring >=25,<26 |

- [下一步：连接平台](connection.html)

## 下载本页 Jupyter Notebook

收录本页 Python 示例与说明，便于在 Jupyter Notebook 中学习和运行；安装命令保留为说明。

[下载《安装 SDK》Notebook（.ipynb）](../../notebooks/sdk_user_guide_install.ipynb)