中文
本页内容

安装openmind Hub Client

在开始安装之前,需要先配置本地环境。openMind Hub Client支持的Python版本是3.8/3.9/3.10,可查阅安装说明。其他版本不保证兼容。

安装指导

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

  1. 创建与激活虚拟环境。

    • Python虚拟环境创建与激活。

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

      shell
      # 创建名为your_venv_name的python 3.8的虚拟环境
      conda create -n your_venv_name python=3.8
      # 激活your_venv_name虚拟环境
      conda activate your_venv_name
      
  2. 使用pip方式安装openMind Hub Client,可根据实际需求选择对应命令进行安装。

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

      shell
      pip install openmind_hub
      
    • 安装所有对接的第三方社区模块,可与所有已对接的第三方社区进行交互,详见《第三方社区对接》

      shell
      pip install openmind_hub[all]
      
    • 安装指定社区模块,可与魔乐或指定社区进行交互。

      shell
      pip install openmind_hub[openi]
      pip install openmind_hub[huggingface]
      

验证安装

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

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

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

卸载

卸载openMind Hub Client:

shell
pip uninstall openmind_hub

提示

通过以下指令可以记录安装和卸载openMind Hub Client的日志,其中LOG_FILE为用户指定的日志路径或日志文件名。

【注意】安装或卸载的日志不会转储,记录前请注意磁盘空间剩余容量。

shell
# 安装openMind Hub Client时记录日志
pip install openmind_hub --log LOG_FILE
shell
# 卸载openMind Hub Client时记录日志
pip uninstall openmind_hub --log LOG_FILE