安装指南

安装前

注解

我们强烈建议您使用虚拟环境安装RQAlpha，以避免因为环境问题出现安装失败。虚拟环境的使用请参考：Anaconda 虚拟环境搭建
如果安装过程中遇到了问题，先阅读该文档下面的「FAQ」章节来尝试着解决
如果执行 pip install 安装依赖库网络速度比较慢的话，推荐使用 pip install -i https://pypi.douban.com/simple 国内镜像来加速

安装

$ pip install -i https://pypi.douban.com/simple rqalpha

查看 RQAlpha 是否安装成功可以通过如下方式:

$ rqalpha version

获取回测数据

RiceQuant 免费提供日级别的股票、常用指数、场内基金和期货数据供回测使用。数据每个月月初更新，可以通过以下命令来下载:

$ rqalpha download-bundle

注解

Mac OS下执行 download-bundle 出现问题，请参考：3. Mac OS 获取回测数据相关问题

bundle 默认存放在 ~/.rqalpha 下，您也可以指定 bundle 的存放位置，

$ rqalpha download-bundle -d target_bundle_path

如果您使用了指定路径来存放 bundle，那么执行程序的时候也同样需要指定对应的 bundle 路径。

$ rqalpha run -d target_bundle_path .....

回测数据的更新

您也可以使用 RQDatac 在每日盘后即时更新回测数据，更新命令如下：

$ rqalpha update-bundle

注解

您需要先安装 RQDatac 包、获取 RQDatac 的使用权限，并使用 Ricequant 提供的配置脚本将您的 RQDatac license 配置到系统环境变量中。请参考: https://www.ricequant.com/welcome/trial/rqdata-cloud

获取配置文件

如果运行 RQAlpha 时不指定配置文件，会在 ~/.rqalpha/ 文件夹下创建 config.yml 文件作为默认配置文件。

如果您想要直接获得一份配置文件，也可以通过如下命令来获得。

$ rqalpha generate-config

FAQ

1. line-profiler 相关问题

RQAlpha 的性能分析功能依赖于 line_profiler 包；通过 pip 安装 RQAlpha 时，默认并不会附带安装 line_profiler；如果您需要使用性能分析功能，请使用 pip install rqalpha[profiler] 方式安装 RQAlpha。

在windows上，建议您访问 http://www.lfd.uci.edu/~gohlke/pythonlibs/#line_profiler 下载 line_profiler 直接进行安装。

在windows上，通过 pip 安装 line-profiler 需要安装 Visual C++ Compiler。请访问 https://wiki.python.org/moin/WindowsCompilers 根据自己的机器环境和Python版本选择安装对应的编译工具。

2. Matplotlib 相关问题

运行回测时，matplotlib 报错怎么办？RuntimeError: Python is not installed as a framework:

解决方案：创建文件 ~/.matplotlib/matplotlibrc，并加入代码 backend: TkAgg

在 Python 3.6 下没有任何报错，但是就是没有plot输出:

解决方案：创建文件 ~/.matplotlib/matplotlibrc，并加入代码 backend: TkAgg

在Windows运行报 Error on import matplotlib.pyplot:

解决方案: 请访问 Error on import matplotlib.pyplot (on Anaconda3 for Windows 10 Home 64-bit PC) 解决。

3. Mac OS 获取回测数据相关问题

Finder中查看数据存放位置：

Mac OS下默认关闭显示隐藏文件，如想在Finder中查看bundle，您需要打开显示隐藏文件：

$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

4. Mac 下安装中文字体相关问题：

出现 Operation not permitted:

因为Mac OS 10.11 EI Capitan 后加入rootless机制，对系统的读写有了更严格的限制，在创建目录环节会出现“Operation not permitted”

您可以通过关闭rootless来解决这个问题。

请重启按住 command + R ，进入恢复模式，打开Terminal：

$ csrutil disable

出现 command not found:

Mac 下默认并没有安装很多命令，我们可以通过homebrew安装，如没有安装homebrew，请参考：

在Terminal下输入：

ruby -e "$(curl --insecure -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

按照系统提示输入密码

wget 命令没有安装：

$ brew install wget

fc--cache 命令没有安装：

$ brew install fontconfig

5. 策略样例路径相关问题：

执行 pip install rqalpha 后虽然会默认保存examples到python环境中，但路径相对复杂，我们建议您将examples目录重新保存到您认为方便的地方。