环境安装 ​

介绍魔乐社区中openMind Hub Client和openMind Library的环境配置。

基于官方镜像安装 ​

为了让用户能够直接使用openMind套件库，现提供了官方镜像。本地运行模型时，可以通过该镜像地址下载镜像并获取镜像的使用说明，快速安装本地开发环境。

Python环境安装配置 ​

安装指导 ​

为避免不同项目间不同依赖项的兼容性问题，推荐在Python或conda虚拟环境中安装openMind Hub Client和openMind Library。有关虚拟环境的安装和管理请详见Python虚拟环境和conda虚拟环境，此处仅提供创建和启用虚拟环境的方法。

• Python虚拟环境创建与使用方式。

# 创建名为your_venv_name的python虚拟环境
python3 -m venv /path/to/your_venv_name
# 激活your_venv_name虚拟环境
source /path/to/your_venv_name/bin/activate

• conda虚拟环境创建与使用方式。

+ 创建名为your_venv_name的python 3.8的虚拟环境
conda create -n your_venv_name python=3.8
# 激活your_venv_name虚拟环境
conda activate your_venv_name

pip安装openMind Hub Client ​

openMind Hub Client可以通过pip方式进行安装，请根据实际环境选择对应的命令进行安装。

• 默认安装方式。可与魔乐社区进行交互。

pip install openmind_hub

• 安装所有对接的第三方社区模块，可与所有已对接的第三方社区进行交互。

pip install openmind_hub[all]

• 安装指定社区模块，可与魔乐或指定社区进行交互。

pip install openmind_hub[openi]

验证安装 ​ ​

安装完成后，使用如下命令检查openMind Hub Client安装是否成功：

python -c "from openmind_hub import repo_info; print(repo_info('Baichuan/PyTorch-NPU/t5_small'))"

此方法会获取到t5_small模型的详细信息。

pip安装openMind Library ​ ​

openMind Library可以通过pip包进行安装，请根据实际环境选择对应的命令进行安装。

• 不安装框架，仅安装openMind Library，可体验魔乐社区上传和下载功能。

  shell

  pip install openmind
  

• 安装openMind Library，并安装PyTorch框架及其依赖。

  shell

  #aarch64环境下安装
  pip install openmind[pt]
  
  #x86环境下安装
  pip install openmind[pt] --extra-index-url https://download.pytorch.org/whl/cpu 
  

• 安装openMind Library，并安装MindSpore框架及其依赖。

  shell

  pip install openmind[ms]
  

安装结果校验 ​

安装openMind Library后，可执行以下命令检验openMind Library是否成功安装。

python -c "import openmind;print(openmind.__version__);"

该命令成功执行，并在终端打印出安装openMind Library的版本号，则表示您成功安装了openMind Library。如下图为成功安装openMind Library后的回显示例，具体版本信息随版本变化：