5分钟上手 Qlib 量化投资平台

本指南将帮助你在5分钟内安装Qlib,下载示例数据,并运行一个简单的股票预测模型示例。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Python >=3.7 必需

所需工具

pip

Python包管理器,用于安装Qlib

必需

操作步骤

1

安装Qlib

使用pip安装Qlib核心包

安装Qlib核心包
pip install pyqlib

预期结果:看到类似 'Successfully installed pyqlib-0.x.x' 的提示

如果安装缓慢,可以使用国内镜像源:pip install pyqlib -i https://pypi.tuna.tsinghua.edu.cn/simple

2

初始化Qlib并下载数据

初始化Qlib工作环境并下载示例数据

初始化Qlib并自动下载示例数据
python -c "import qlib; qlib.init()"

预期结果:看到数据下载进度条和 'qlib successfully initialized' 提示

首次运行会自动下载约200MB的示例数据,请确保网络连接正常

3

运行简单示例

运行一个基于LightGBM的股票预测模型示例

测试核心组件导入
python -c "from qlib.contrib.data.handler import Alpha158; from qlib.contrib.model.gbdt import LGBModel; from qlib.contrib.strategy import TopkDropoutStrategy; print('Qlib示例组件导入成功!')"

预期结果:看到 'Qlib示例组件导入成功!' 输出

这只是导入测试,完整的训练流程需要更多代码,但验证了安装成功

验证成功

如果所有步骤都顺利完成,说明Qlib已正确安装并初始化

pip安装成功无报错
qlib.init()显示初始化成功
示例组件可以正常导入

快速提示

配置

如果遇到权限问题,可以在pip install命令后添加 --user 参数

配置

数据默认下载到 ~/.qlib/qlib_data/cn_data 目录

配置

想使用其他市场数据,可以在qlib.init()时指定provider_uri参数

常见问题

1

pip安装失败,提示找不到pyqlib

确保pip是最新版本:pip install --upgrade pip,然后重试

2

qlib.init()下载数据失败或超时

可以手动下载数据:从GitHub releases页面下载数据,解压到~/.qlib/qlib_data目录

3

导入模块时出现版本兼容性错误

确保Python版本>=3.7,并尝试重新安装:pip install --force-reinstall pyqlib

下一步

查看官方示例

访问GitHub仓库的examples目录,运行完整的工作流示例

阅读文档

访问 https://qlib.readthedocs.io 了解详细使用指南

尝试RD-Agent

探索基于LLM的自动化因子挖掘和模型优化功能

助手