跳转至

安装指南

系统要求

  • Python 3.10 或更高版本
  • Windows 系统（推荐 Windows 10/11）
  • 支持 QMT 交易（可选，用于实盘交易）

安装方法

从 PyPI 安装（推荐）

pip install qka

从源码安装

如果你想使用最新的开发版本，可以从 GitHub 源码安装：

git clone https://github.com/zsrl/qka.git
cd qka
pip install -e .

安装开发依赖

如果你想要构建文档或运行测试，可以安装开发依赖：

pip install qka[dev]

依赖说明

QKA 依赖于以下主要包：

  • akshare: 数据获取
  • fastapi: Web 服务器框架
  • plotly: 数据可视化
  • pandas: 数据处理
  • dask: 并行计算
  • xtquant: QMT Python 接口

完整的依赖列表请参考 pyproject.toml。

验证安装

安装完成后，可以通过以下方式验证安装是否成功：

import qka

print(f"QKA 版本: {qka.__version__}")

# 检查核心模块是否可用
try:
    from qka import Data, Backtest, Strategy
    print("核心模块导入成功")
except ImportError as e:
    print(f"导入失败: {e}")

常见问题

Q: 安装过程中出现依赖冲突怎么办？

A: 建议使用虚拟环境来避免依赖冲突：

# 创建虚拟环境
python -m venv qka_env

# 激活虚拟环境（Windows）
qka_env\Scripts\activate

# 安装 QKA
pip install qka

Q: 如何更新到最新版本？

A: 使用 pip 更新：

pip install --upgrade qka

Q: 安装 xtquant 失败怎么办？

A: xtquant 是 QMT 的 Python 接口，如果你不需要实盘交易功能，可以跳过这个依赖。如果需要，请确保已安装 QMT 并正确配置环境。

下一步

安装完成后，建议继续阅读：