安装指南#
1 系统要求#
安装要求:
Python >= 3.7 (推荐版本为Python 3.7)
支持系统:
Linux (Ubuntu, …)
macOS
Windows
2 预先准备#
我们强烈建议您为OpenBox创建一个单独的Python环境,例如通过 Anaconda:
conda create -n openbox python=3.7
conda activate openbox
我们建议您在安装OpenBox之前通过以下命令更新pip
,setuptools
和wheel
:
pip install --upgrade pip setuptools wheel
3 安装 OpenBox#
3.1 使用 PyPI 安装#
只需运行以下命令:
pip install openbox
如需使用高级功能,请先安装SWIG
,然后运行 pip install "openbox[extra]"
。
3.2 从源代码手动安装#
使用以下命令通过Github源码安装最新版本的OpenBox:
git clone https://github.com/PKU-DAIR/open-box.git && cd open-box
pip install .
同样,如需使用高级功能,请先安装SWIG
,然后运行 pip install ".[extra]"
。
3.3 安装测试#
运行以下代码以测试您安装是否成功:
from openbox import run_test
if __name__ == '__main__':
run_test()
如果成功,将输出以下信息:
===== Congratulations! All trials succeeded. =====
如果您在安装过程中遇到任何问题,请参考 疑难解答 。
4 进阶功能安装(可选)#
如果您想使用更高级的功能,比如使用 pyrfr
(概率随机森林)作为代理模型,或根据历史计算超参数重要性,
请先安装SWIG,然后运行:
pip install "openbox[extra]"
如果您在安装pyrfr
时遇到问题,请参考 Pyrfr安装教程。
5 疑难解答#
如果以下未能解决您的安装问题, 请在Github上提交issue 。