# Deep Learning-on-musa

**Repository Path**: mthreadsacademy/deep-learning-on-musa

## Basic Information

- **Project Name**: Deep Learning-on-musa
- **Description**: 这是一个开源项目，旨在为《动手学深度学习》（ 原书链接https://zh.d2l.ai/） 提供基于摩尔线程 MUSA (Moore Threads Unified System Architecture) 平台的完整适配。本仓库包含了原书中所有章节的代码示例，并已成功在摩尔线程的 GPU 上进行验证与优化，以充分利用 MUSA 的计算能力。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Deep Learning - The Straight Dope

#### 介绍
这是一个开源项目，旨在为 原书链接https://zh.d2l.ai/ 的《动手学深度学习》提供基于摩尔线程 MUSA (Moore Threads Unified System Architecture) 平台的完整适配。本仓库包含了原书中所有章节的代码示例，并已成功在摩尔线程的 GPU 上进行验证与优化，以充分利用 MUSA 的计算能力。

#### 软件架构
本项目的软件架构主要围绕适配《动手学深度学习》中的代码示例在摩尔线程 MUSA 平台运行展开。其核心组件包括：

* （1）代码移植与适配层：将原书基于 PyTorch深度学习框架的代码，适配到支持 MUSA 的深度学习框架。
* （2）MUSA 后端优化：针对摩尔线程 GPU 的特性，对模型训练和推理过程进行底层优化，确保高效的计算性能。
* （3）依赖管理：管理所有必要的软件依赖，包括 MUSA 驱动、MUSA SDK、适配后的深度学习框架版本等。
* （4）示例代码组织：按照原书章节结构组织代码，方便用户查找和学习。




#### 安装教程

为了顺利运行本项目，请确保你的系统满足以下要求并按照步骤进行安装。

1.  *准备摩尔线程 GPU 环境：*
    * 确保您的机器上已正确安装摩尔线程 GPU 硬件。
    * 根据摩尔线程官方文档，安装最新版本的MUSA 驱动和MUSA SDK。
    * 验证 MUSA 环境是否配置成功。
2.  *克隆本项目：*
    * git clone https://gitee.com/mthreadsacademy/deep-learning-on-musa.git
3.  *创建并配置虚拟训练环境：*
    * 建议版本：pytorch 2.2.0 python 3.10 MuSA 3.1.0

#### 使用说明

1.  *浏览章节代码：*
    * 代码文件按章节组织，例如 `chapter_02/`, `chapter_03/` 等。
    * 每个章节文件夹内包含该章节的所有代码示例文件。

2.  *安装项目依赖：*
    * 安装必要的d2l-2.0.0-py3-none-any.whl文件。打开终端或命令提示符，运行以下命令：
    pip install d2l-2.0.0-py3-none-any.whl
3.  *启动 jupyter Notebook（推荐学习方式）：*
    jupyter notebook


#### 参与贡献

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/)