Installing MindSpore CPU by Conda

• Installing MindSpore CPU by Conda
  • Automatic Installation
  • Manual Installation
    • Installing Conda
    • Installing GCC and gmp
    • Creating and Accessing the Conda Virtual Environment
    • Installing MindSpore
  • Installation Verification
  • Version Update

Conda is an open-source, cross-platform, language-agnostic package manager and environment management system. It allows users to easily install different versions of binary software packages and any required libraries appropriate for their computing platform.

This document describes how to quickly install MindSpore by Conda in a Linux system with a CPU environment. The following takes Ubuntu 18.04 as an example to describe how to install MindSpore.

• If you want to install MindSpore by Conda on a fresh Ubuntu 18.04, you may use automatic installation script for one-click installation, see Automatic Installation section. The automatic installation script will install MindSpore and its dependencies.

• If some dependencies, such as Conda and GCC, have been installed in your system, it is recommended to install manually by referring to the installation steps in the Manual Installation section.

Automatic Installation

The automatic installation script needs to replace the source list and install dependencies via APT, it will apply for root privileges during execution. Run the following command to obtain and run the automatic installation script. The automatic installation script only supports the installation of MindSpore>=1.6.0.

wget https://gitee.com/mindspore/mindspore/raw/r1.8/scripts/install/ubuntu-cpu-conda.sh
# install Python 3.7 and the latest MindSpore by default
bash ./ubuntu-cpu-conda.sh
# to specify Python and MindSpore version, taking Python 3.9 and MindSpore 1.6.0 as examples, use the following manners
# PYTHON_VERSION=3.9 MINDSPORE_VERSION=1.6.0 bash ./ubuntu-cpu-conda.sh

This script performs the following operations:

• Change the software source configuration to a HUAWEI CLOUD source.
• Install the dependencies required by MindSpore, such as GCC and gmp.
• Install Conda and create a virtual environment for MindSpore.
• Install MindSpore CPU by Conda.

After the automatic installation script is executed, you need to reopen the terminal window to make the environment variables take effect. The automatic installation script creates a virtual environment named mindspore_pyXX for MindSpore. Where XX is the Python version, such as Python 3.7, the virtual environment name is mindspore_py37. Run the following command to show all virtual environments.

conda env list

To activate the virtual environment, take Python 3.7 as an example, execute the following command.

conda activate mindspore_py37

For more usage, see the script header description.

Manual Installation

The following table lists the system environment and third-party dependencies required to install MindSpore.

The following describes how to install the third-party dependencies.

Installing Conda

Run the following command to install Miniconda.

cd /tmp
curl -O https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py37_4.10.3-Linux-$(arch).sh
bash Miniconda3-py37_4.10.3-Linux-$(arch).sh -b
cd -
. ~/miniconda3/etc/profile.d/conda.sh
conda init bash

After the installation is complete, you can set up Tsinghua source acceleration download for Conda, and see here.

Installing GCC and gmp

Run the following commands to install GCC and gmp.

sudo apt-get install gcc-7 libgmp-dev -y

To install a later version of GCC, run the following command to install GCC 8.

sudo apt-get install gcc-8 -y

Or install GCC 9.

sudo apt-get install software-properties-common -y
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-9 -y

Creating and Accessing the Conda Virtual Environment

Create a Conda virtual environment based on the Python version you want and activate the virtual environment.

If you want to use Python 3.7.5:

conda create -c conda-forge -n mindspore_py37 python=3.7.5 -y
conda activate mindspore_py37

If you wish to use another version of Python, just change the Python version in the above command. Python 3.7, Python 3.8 and Python 3.9 are currently supported.

Installing MindSpore

Ensure that you are in the Conda virtual environment and run the following command to install the latest MindSpore. To install other versions, please refer to the specified version number of Version List after mindspore-ascend=.

conda install mindspore-cpu -c mindspore -c conda-forge

When the network is connected, dependency items are automatically downloaded during .whl package installation. (For details about the dependency, see required_package in setup.py .) In other cases, you need to install it by yourself. When running models, you need to install additional dependencies based on requirements.txt specified for different models in ModelZoo. For details about common dependencies, see requirements.txt.

Installation Verification

python -c "import mindspore;mindspore.run_check()"

The outputs should be the same as:

MindSpore version: __version__
The result of multiplication calculation is correct, MindSpore has been installed successfully!

It means MindSpore has been installed successfully.

Version Update

Use the following command if you need to update the MindSpore version:

conda update mindspore-cpu -c mindspore -c conda-forge