# ascend-devkit-model-adapter

**Repository Path**: HUAWEI-ASCEND/ascend-devkit-model-adapter

## Basic Information

- **Project Name**: ascend-devkit-model-adapter
- **Description**: 昇腾开发者套件配套的模型适配工具代码仓。 模型适配工具是一款集成数据标注、模型迁移学习、模型打包为一体的开发者工具套件。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/ascend/ascend-devkit-model-adapter
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 10
- **Created**: 2023-04-01
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ascend devkit model adapter

## 介绍
昇腾开发者套件配套的模型适配工具代码仓。模型适配工具是一款集成数据标注、模型迁移学习、模型打包为一体的开发者工具套件。

## 安装教程

1.  模型适配工具的运行依赖于Anaconda虚拟环境，在安装工具前需准备好虚拟环境，本文以Anaconda3 2022.10版本为例。
下载文件[Anaconda3-2022.10-Windows-x86_64.exe](https://repo.anaconda.com/archive/Anaconda3-2022.10-Windows-x86_64.exe)
2. 安装时勾选“Add Anaconda3 to my PATH environment variable”选项
3. 安装完成后，使用快捷键“Win+R”，在运行窗口输入cmd，单击“确定”按钮。进入命令行窗口。
4. 输入conda --version，确认安装成功。
5. 下载conda的虚拟环境压缩包。
[下载链接](https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/Atlas%20200I%20DK%20A2/DevKit/tools/latest/model-adapter-tool.tar.gz)
6. 将下载的虚拟环境压缩包解压到Anaconda安装目录下的envs目录中并保证文件夹名称为“model-adapter-tool”。
7. 在命令行中执行 conda info -e 查看虚拟环境是否已创建。如出现 model-adapter-tool       C:\Users\username\Anaconda3\envs\model-adapter-tool 回显，则说明虚拟环境创建成功。

## 使用说明

具体使用说明请参考[模型适配工具使用说明](https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/23.0.RC1/Getting%20Started%20with%20Application%20Development/iaqd/iaqd_0002.html)

## 编译构建

### 1. 安装NSIS

参考制卡工具的[编译环境搭建wiki](https://gitee.com/HUAWEI-ASCEND/ascend-devkit/wikis/%E7%BC%96%E8%AF%91%E6%9E%84%E5%BB%BA/%E5%88%B6%E5%8D%A1%E5%B7%A5%E5%85%B7%E6%BA%90%E7%A0%81%E7%BC%96%E8%AF%91?sort_id=5993712)，按照其中的步骤6和步骤7操作（安装NSIS并配置NSIS环境变量）

### 2. 导入conda环境

#### 2.1 下载conda环境导出包：

[下载链接](https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/Atlas%20200I%20DK%20A2/DevKit/tools/latest/model-adapter-tool.tar.gz)

conda环境导出包的版本需要注意与模型适配工具的版本保持兼容。

#### 2.2 解压并复制导出包
解压后得到model-adapter-tool文件夹，复制到你的anaconda\env目录，一般位于用户主目录下，例如在我的电脑上路径是C:\Users\****\anaconda3\envs



复制完成后，env目录下应该有model-adapter-tool文件夹。


解压时应注意直接解压到单层一个目录（model-adapter-tool/...）下，不要出现 envs/model-adapter-tool/model-adapter-tool/... 这种情况。

### 3. 编译和构建

修改build/build_model_adapter.cmd中的这一行，其中的路径改为你的conda安装目录：
```call C:\ProgramData\anaconda3\envs\model-adapter-tool\Scripts\activate.bat```

这一步是必须的，否则无法激活conda环境，会导致编译出的exe闪退。

打开命令行，cd到ascend-devkit\build目录下，执行
```.\build.cmd```

构建时间比较长，特别是在nsis编译时可能会花费十几分钟，需要耐心等待。

编译完成后会在ascend-devkit\build\output目录下生成两个exe，一个是安装包，一个是升级包。



#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)