Skip to content

Installation

Dependency

  • mindspore >= 1.8.1
  • numpy >= 1.17.0
  • pyyaml >= 5.3
  • tqdm
  • openmpi 4.0.3 (for distributed mode)

To install the python library dependency, just run:

pip install -r requirements.txt

Tip

MindSpore can be easily installed by following the official instructions where you can select your hardware platform for the best fit. To run in distributed mode, OpenMPI is required to install.

The following instructions assume the desired dependency is fulfilled.

Install with PyPI

MindCV is published as a Python package and can be installed with pip, ideally by using a virtual environment. Open up a terminal and install MindCV with:

pip install mindcv
# working on it using test.pypi

This will automatically install compatible versions of dependencies: NumPy, PyYAML and tqdm.

Tip

If you don't have prior experience with Python, we recommend reading Using Python's pip to Manage Your Projects' Dependencies, which is a really good introduction to the mechanics of Python package management and helps you troubleshoot if you run into errors.

Warning

The above command will NOT install MindSpore. We highly recommend you install MindSpore following the official instructions.

Install from Source (Bleeding Edge Version)

from VCS

pip install git+https://github.com/mindspore-lab/mindcv.git

from local src

Tip

As this project is in active development, if you are a developer or contributor, please prefer this installation!

MindCV can be directly used from GitHub by cloning the repository into a local folder which might be useful if you want to use the very latest version:

git clone https://github.com/mindspore-lab/mindcv.git

After cloning from git, it is recommended that you install using "editable" mode, which can help resolve potential module import issues:

cd mindcv
pip install -e .