Cqlib-QML

August 25, 2026 · View on GitHub

英文版见 English version。

本项目是基于 Cqlib 的量子机器学习 Python 工具包，提供经典数据量子编码、参数化量子线路、纯量子与混合量子—经典神经网络、量子核方法及模型训练组件。

安装说明

环境要求：Python 3.10 及以上版本。

从源码安装：

git clone https://github.com/cq-lib/cqlib-qml.git
cd cqlib-qml
pip install .

发布到 PyPI 后，也可以直接安装：

pip install cqlib-qml

开发环境安装：

pip install -r requirements-dev.txt
pip install -e .

主要功能

  • encoder：将经典向量和图像编码为量子线路，支持振幅编码、角度编码、基态编码、FRQI、NEQR、Qubit Lattice 和 ZZ Feature Map。
  • ansatz：参数化量子线路，包含硬件高效线路、BasicQNN、CRADL 和 CRAML。
  • models：纯量子神经网络 QNN、混合量子—经典神经网络 HQNN，以及用于组合量子与经典组件的 Module。
  • algorithms：量子核方法 QKM、量子支持向量机 QSVM 和兼容 scikit-learn 接口的变分量子分类器 VQC。
  • differentiator：伴随法和参数偏移法量子梯度计算。
  • layer：全连接层与常用激活函数，用于构建混合模型的经典部分。
  • data：数据集、批加载和图像数据预处理工具。
  • loss / optimizer / scheduler：常用损失函数、参数优化器和学习率调度器。

快速开始

下面使用角度编码和量子核构造核矩阵：

import numpy as np

from cqlib_qml.algorithms import QKM
from cqlib_qml.encoder import AngleEncoder

encoder = AngleEncoder(mode="classical")
kernel = QKM(encoder=encoder)

samples = np.array([
    [0.1, 0.2],
    [0.3, 0.4],
    [0.5, 0.6],
])

kernel_matrix = kernel.kernel(samples)
print(kernel_matrix)

构建量子神经网络：

from cqlib_qml.ansatz import HEAnsatz
from cqlib_qml.models import QNN

ansatz = HEAnsatz(n_qubits=4, d=2, layers=["RY", "CX"])
ansatz.set_measurement(readouts=[0])
model = QNN(ansatz=ansatz)

更多说明参见 docs/tutorials 和 docs/api。

测试

pytest

License

Apache License 2.0，详见 LICENSE。

Contributing

欢迎贡献！如需改进功能或修复缺陷，请提交 Issue 或发起 Pull Request。