# ModelArts-Ascend

**Repository Path**: ModelArts/modelarts-ascend

## Basic Information

- **Project Name**: ModelArts-Ascend
- **Description**: 华为云昇腾云服务代码仓
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 2
- **Created**: 2023-04-28
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: sample-code, ai

**Tags**: None

## README

# ModelArts-Ascend

## 介绍
基于华为云ModelArts平台的示例代码库，本仓库中放置和昇腾迁移相关的具体实例和最佳时间，可以在ModelArts开发环境中直接运行和复现
## 如何使用
[notebook](notebooks/)文件夹中提供了一些PyTorch模型迁移到Ascend的jupyter notebook样例，可以直接在ModelArts开发环境中运行。具体的步骤如下：


**Step1: 注册自定义镜像**

用上文提到的镜像进行自定义镜像注册，注意，当前只支持北京四区域
![注册镜像入口](docs/imgs/image_manager.png)
<center>图1 注册镜像入口</center>

镜像源可以参考表中的镜像
|镜像名称|区域|SWR地址|
|----|---|---|
|mslite-2.0.0-cann-6.3.1  | 北京四 | swr.cn-north-4.myhuaweicloud.com/dev-custom/mslite-2.0.0-cann-6.3.1:0.0.4 | 

![注册自定义镜像](docs/imgs/register_image.png)
<center>图2 注册自定义镜像</center>

**Step2: 创建开发实例**

资源选择，`Ascend 1*Ascend910`

存储，建议云硬盘，按照对应的存储使用情况可选择存储大小

SSH远程开发，添加自己的Key Pair，可以进行远程开发，如通过VSCode remote development直接连接到实例中（可选）

![实例创建入口](docs/imgs/create.png)
<center>图3 实例创建入口</center>

![实例创建](docs/imgs/self_defined_image.png)
<center>图4 实例创建</center>

![运行实例](docs/imgs/image_list.png)
<center>图5 运行实例</center>

**Step3: 使用ModelArts开发环境运行jupyter notebook样例**
点击`打开`即可进入ModelArts开发环境界面，点击`+` -> `Terminal`即可打开命令行界面，下载代码仓到本地即可使用。

```shell
git clone https://gitee.com/ModelArts/modelarts-ascend.git
```
![线上Notebook入口](docs/imgs/notebook.png)
<center>图6 线上Notebook入口</center>

点击notebook文件夹中的`ipynb`文件即可交互式运行Ascend迁移样例
![线上Notebook入口](docs/imgs/ipynb.png)
<center>图7 交互式执行Notebook</center>