# 安装

## 硬件和操作系统支持情况

| 硬件平台   | 操作系统            | 状态  |
| ------ | --------------- | --- |
| Ascend | EulerOS-aarch64 | √   |
|        | Ubuntu-aarch64  | √   |
|        | Ubuntu-x86_64   | √   |
|        | CentOS-aarch64  | √   |
|        | CentOS-x86_64   | √   |
| CPU    | Windows-aarch64 | √   |

## 前置依赖

- Python $\ge$ 3.7, $\lt$ 3.12
- MindSpore == 2.7.0
- CANN $\ge$ 8.2.rc1

MindSpore安装教程请参考[MindSpore官网](https://www.mindspore.cn/install)，CANN安装请参考[Ascend官网](https://www.hiascend.com/document)。

## 安装步骤概览

1. 准备 Python 虚拟环境（推荐）：

   ```bash
   python -m venv venv
   source venv/bin/activate
   ```

2. 按需安装 MindSpore（Ascend/CPU/GPU 版本）与匹配的 CANN。

3. 克隆仓库并安装依赖：

   ```bash
   git clone https://gitcode.com/mindspore-lab/mindscience.git
   cd mindscience
   pip install -r requirements.txt
   ```

4. 编译生成安装包：

   ```bash
   bash build.sh
   ```

5. 安装 MindScience：

   ```bash
   pip install output/mindscience-*.whl
   ```

6. 验证安装：

   ```bash
   python - <<'PY'
   import mindspore as ms
   import mindscience
   print("MindSpore:", ms.__version__)
   print("MindScience:", mindscience.__version__)
   PY
   ```

## 源码安装

- 代码仓下载源码

```bash
git clone https://gitcode.com/mindspore-lab/mindscience.git
cd mindscience
```

- 安装依赖项

```bash
pip install -r requirements.txt
```

- 源码编译

```bash
bash build.sh
```

- mindscience安装

```bash
pip install output/mindscience-*.whl
```