安装指南

1 系统要求

安装要求:

  • Python >= 3.6 (推荐版本为Python 3.7)

支持系统:

  • Linux (Ubuntu, …)

  • macOS

  • Windows

2 预先准备

我们强烈建议您为MindWare创建一个单独的Python环境,例如通过Anaconda:

conda create -n mindware python=3.7
conda activate mindware

我们建议您在安装OpenBox之前通过以下命令更新pipsetuptools

pip install pip setuptools --upgrade

3 安装 MindWare

3.1 使用 PyPI 安装

只需运行以下命令:

pip install mindware

3.2 从源代码手动安装

使用以下命令通过Github源码安装MindWare:

git clone https://github.com/thomas-young-2013/mindware.git && cd mindware
cat requirements/main.txt | xargs -n 1 -L 1 pip install
python setup.py install

3.3 安装测试 (TODO)

运行以下代码以测试您安装是否成功:

from mindware import run_test

if __name__ == '__main__':
    run_test()

如果成功,将输出以下信息:

===== Congratulations! All trials succeeded. =====

如果您在安装过程中遇到任何问题,请参考 疑难解答

4 进阶功能安装(可选)

如果您想使用更高级的功能,比如在超参数优化过程中使用 pyrfr (概率随机森林)作为代理模型, 请参考 Pyrfr安装教程 并安装 pyrfr

5 疑难解答

如果以下未能解决您的安装问题, 请在Github上提交issue 或发送邮件至liyang.cs@pku.edu.cn.

如果您未能正确安装openbox,您也可以参考OpenBox 安装指南.

Windows

  • ‘Error: [WinError 5] 拒绝访问’。请使用管理员权限运行命令行,或在命令后添加--user

  • ‘ERROR: Failed building wheel for ConfigSpace’。请参考提示

macOS

  • 对于 macOS 用户,如果您在安装 pyrfr 时遇到了困难,请参考 提示

  • 对于 macOS 用户,如果您在编译 scikit-learn 时遇到了困难。 该教程 或许对你有帮助。