安装指南¶
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之前通过以下命令更新pip
和setuptools
:
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’。请参考提示。