• MSAdapter
• • 简介
  • 安装
  • • 安装MindSpore
    • 安装MSAdapter
    • • 通过pip安装
      • 通过源码安装
  • 使用
  • 资源
  • 版本说明
  • 正在进行的工作
  • 贡献
  • 加入我们
  • 许可证

MSAdapter

简体中文 | English

简介

MSAdapter是将PyTorch训练脚本高效迁移至MindSpore框架执行的工具，其目的是在不改变原有PyTorch用户的使用习惯情况下，使得PyTorch代码能在昇腾上获得高效性能。

• PyTorch接口支持： MSAdapter的目的是支持PyTorch语法的原生态表达，用户只需要将PyTorch源代码中import torch替换为import msadapter.pytorch即可实现模型能支持昇腾上训练。模型中所使用的高阶APIs支持状态可以从这里找到 Supported List。
• PyTorch接口支持范围： MSAdapter目前主要适配PyTorch的数据处理和模型结构部分代码，目前完全支持MindSpore的PYNATIVE模式下训练，部分网络结构支持GRAPH模式训练。
• TorchVision接口支持： MSAdapter TorchVision是迁移自PyTorch官方实现的计算机视觉工具库，延用PyTorch官方api设计与使用习惯，内部计算调用MindSpore算子，实现与torchvision原始库同等功能。用户只需要将PyTorch源代码中import torchvision替换为import msadapter.torchvision即可。TorchVision支持状态可以从这里找到 TorchVision Supported List。

安装

首先查看版本说明选择所需的MSAdapter和MindSpore版本。

安装MindSpore

请根据MindSpore官网安装指南 进行安装。

安装MSAdapter

通过pip安装

pip install msadapter

通过源码安装

 git clone https://git.openi.org.cn/OpenI/MSAdapter.git
 cd MSAdapter
 python setup.py install

如果出现权限不足的提示，请按照如下方式安装：

 python setup.py install --user || exit 1

使用

参考MSAdapter用户使用指南，您将快速入门完成PyTorch原生代码的迁移，以及上手各种进阶优化手段；如果您有对精度和性能调优的需求可参考MSAdapter调试调优指南。

资源

• 模型库：MSAdapter支持丰富的深度学习应用，这里给出了从PyTorch官方代码迁移到MSAdapter模型。已验证模型资源

版本说明

分支名	发布版本	发布时间	配套MindSpore版本	启智算力资源
release_0.1	0.1	2023-06-15	MindSpore 2.0.0	智算网络集群 - 镜像：mindspore2.0.0_cann6.3_notebook
release_0.1rc	0.1rc	2023-04-23	MindSpore 2.0.0rc1	智算网络集群 - 镜像：mindspore2.0rc_cann6.3_notebook
release_0.1beta	0.1beta	2023-03-27	MindSpore Nightly(0205)	-
master	-	-	MindSpore 2.1.0 8月11日及以后的版本	-

• MSAdapter已发布版本获取请参阅RELEASE。
• MindSpore版本推荐从MindSpore官网获取，或者从启智平台数据资源中获取。

正在进行的工作

• 支持更多torch的接口。
• 支持torchaudio数据处理接口。
• 性能优化。

贡献

欢迎开发者参与贡献。更多详情，请参阅我们的贡献指南.

加入我们

如果您在使用时有任何问题或建议，欢迎加入MSAdapter SIG参与讨论。

许可证

Apache License 2.0