Share via

Configurer Windows Python

  • Article

Installation de CNTK pour Python sur Windows

Cette page vous guide tout au long du processus d’installation du Microsoft Cognitive Toolkit (CNTK) à utiliser à partir de Python dans Windows. Si vous recherchez d’autres types de support pour configurer un environnement de build CNTK ou installer des CNTK sur votre système, vous devez vous rendre ici à la place.

Nous proposons trois façons d’installer CNTK pour Python :

  1. Installation de PyPI
  2. Fichiers Wheel (.whl) pour chaque version
  3. Builds nocturnes

1. Installer à partir de PyPI

À compter de la version CNTK 2.5, les utilisateurs peuvent désormais installer CNTK via PyPI.

Si c’est la première fois que vous installez CNTK via PyPI, nous vous conseillons de désinstaller d’abord toutes les versions précédentes : pip uninstall <url>.

Première installation de CNTK

Pour installer la version uc seule de CNTK :

C:\> pip install cntk

Pour installer la version GPU de CNTK :

C:\> pip install cntk-gpu

Mettre à niveau une installation CNTK existante

Si vous disposez déjà d’une version antérieure (2.5+) de CNTK installée, vous pouvez installer une nouvelle version de CNTK sur votre installation existante.

Pour mettre à niveau la version uc seule de CNTK :

C:\> pip install --upgrade --no-deps cntk

Pour mettre à niveau la version GPU de CNTK :

C:\> pip install --upgrade --no-deps cntk-gpu

Remarque : nous vous conseillons de ne pas avoir les deux cntk packages cntk-gpu installés simultanément.

2. Installer à partir de Wheel Files

En fonction de python et de CNTK version (PROCESSEUR ou GPU), nous fournissons différents fichiers wheel (.whl) pour installer CNTK. Sélectionnez l’installation correcte dans la liste ci-dessous, puis remplacez le nom et/ou le lien pendant l’installation. Pour CNTK 2.5+, nous vous recommandons d’installer simplement via PyPI à la place.

Python Saveur URL
2.7 CPU-Only https://cntk.ai/PythonWheel/CPU-Only/cntk-2.7.post1-cp27-cp27m-win_amd64.whl
GPU https://cntk.ai/PythonWheel/GPU/cntk_gpu-2.7.post1-cp27-cp27m-win_amd64.whl
3,5 CPU-Only https://cntk.ai/PythonWheel/CPU-Only/cntk-2.7.post1-cp35-cp35m-win_amd64.whl
GPU https://cntk.ai/PythonWheel/GPU/cntk_gpu-2.7.post1-cp35-cp35m-win_amd64.whl
3.6 CPU-Only https://cntk.ai/PythonWheel/CPU-Only/cntk-2.7.post1-cp36-cp36m-win_amd64.whl
GPU https://cntk.ai/PythonWheel/GPU/cntk_gpu-2.7.post1-cp36-cp36m-win_amd64.whl

Anaconda3

Nous avons testé CNTK avec Anaconda3 4.1.1 (64 bits) et Python versions 2.7 et 3.5, ainsi qu’Anaconda3 4.3.1 avec Python version 3.6. Si vous n’avez pas d’installation d’Anaconda3 Python, installez Anaconda3 4.1.1 Python pour Windows (64 bits).

Ci-dessous, nous supposons qu’Anaconda est installé et qu’il est répertorié avant toute autre installation Python dans votre chemin d’accès. Si vous envisagez d’utiliser une version compatible GPU de CNTK, vous aurez besoin d’une carte graphique compatible CUDA 9 et de pilotes graphiques à jour installés sur votre système. Vérifiez que vous installez CUDA 9.0 et non CUDA 9.1.

installation pip sans environnement

Il s’agit de l’option la plus simple et la seule raison de l’éviter, c’est si vous avez besoin de versions spécifiques de certains packages. Si vous avez d’autres packages qui nécessitent une ancienne version de numpy, passez à cette section.

Première installation de CNTK

Si c’est la première fois que vous installez CNTK, exécutez

C:\> pip install <url>

où <url> est l’URL de fichier wheel correspondante dans le tableau en haut de cette page. Par exemple, si vous avez Python 3.5 et que vous souhaitez installer la version processeur uniquement, exécutez

C:\> pip install https://cntk.ai/PythonWheel/CPU-Only/cntk-2.6-cp35-cp35m-win_amd64.whl

Continuer avec un test d’installation rapide

Mettre à niveau une installation CNTK existante

Si vous avez déjà installé une version antérieure de CNTK, vous pouvez installer une nouvelle version de CNTK sur votre installation existante. Il est important de fournir les options et --no-deps les --upgrade options.

C:\> pip install --upgrade --no-deps <url>

où <url> est l’URL de fichier wheel correspondante dans le tableau en haut de cette page. Une fois que vous avez terminé cette étape de mise à niveau, vous pouvez commencer à utiliser CNTK dans Python ou installer des exemples et des didacticiels.

Test d’installation rapide

Un test rapide que l’installation a réussi peut être effectué en interrogeant la version CNTK :

C:\> python -c "import cntk; print(cntk.__version__)"

Vous avez maintenant installé CNTK, et vous pouvez commencer à développer / former / évaluer avec CNTK dans Python !

Continuer avec l’installation d’exemples et de didacticiels

installation pip dans un environnement

Ci-dessous, nous allons créer un environnement Python 3.5 dans Anaconda appelé cntk-py35 et installera CNTK dans cet environnement. Si vous souhaitez une autre version CNTK, une version Python ou un autre nom d’environnement, ajustez les paramètres en conséquence.

Ouvrez un interpréteur de commandes standard, créez l’environnement, rendez-le actif et pip-install CNTK :

C:\> conda create --name cntk-py35 python=3.5 numpy scipy h5py jupyter
C:\> activate cntk-py35
C:\> pip install https://cntk.ai/PythonWheel/CPU-Only/cntk-2.6-cp35-cp35m-win_amd64.whl

Un test rapide que l’installation a réussi peut être effectué en interrogeant la version CNTK :

C:\> python -c "import cntk; print(cntk.__version__)"

Vous avez maintenant installé CNTK, et vous pouvez commencer à développer / former / évaluer avec CNTK dans Python !

Poursuivre l’installation d’exemples et de didacticiels

Anaconda2

Si vous avez besoin d’un environnement racine Python 2.7, nous vous recommandons d’installer Anaconda2 4.3.0.1 (64 bits).

Ci-dessous, nous partons du principe qu’Anaconda2 est installé et qu’il est répertorié avant toute autre installation Python dans votre chemin d’accès. Si vous envisagez d’utiliser une version compatible GPU de CNTK, vous aurez besoin d’une carte graphique compatible CUDA 9 et de pilotes graphiques à jour installés sur votre système.

Anaconda2 : conditions préalables CNTK

CNTK nécessite l’installation Visual C++ Redistributable for Visual Studio 2017 sur votre système (dans de nombreux cas, cela sera déjà le cas). Le programme d’installation du runtime VS2017 (VC_redist.x64.exe) peut être téléchargé ici.

Anaconda2 : pip install

Les étapes d’installation de CNTK sur Anaconda2 sont identiques à

Veillez simplement à sélectionner des fichiers wheel compatibles Python 2.7 dans la table d’URL en haut de cette page.

3. Installer à partir de builds Nocturnes

Si vous préférez installer ou mettre à niveau CNTK à partir de la dernière version nocturne plutôt qu’une version officielle, nous proposons CNTK packages nocturnes. Vous pouvez accéder aux packages CNTK à partir des dernières builds nocturnes ici.

Si vous utilisez une build nocturne, vous devez installer séparément certains packages tiers et les ajouter à votre variable d’environnement PATH. Suivez la section ci-dessous pour obtenir des instructions. Par exemple, si vous installez la version GPU de CNTK, vous devez également installer les packages spécifiques au GPU répertoriés dans la section suivante.

Variables d’environnement et packages requis

FACULTATIF : packages GPU-Specific

Si vous envisagez d’utiliser CNTK avec GPU, suivez cette page pour installer et configurer l’environnement en conséquence.

Après avoir installé les packages GPU mentionnés ci-dessus, ajoutez-les à votre variable d’environnement PATH, par exemple.

setx PATH "C:\Program Files\NVIDIA Corporation\NVSMI;%PATH%"
setx PATH "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v9.0\bin;%PATH%"
setx PATH "C:\local\cudnn-9.0-v7.0\cuda\bin;%PATH%"
MKL

La bibliothèque mathématique par défaut CNTK est la bibliothèque Intel Math Kernel Library (Intel MKL). Suivez cette page pour l’installer dans votre système.

  • Ajoutez son chemin d’accès à la variable PATHd’environnement, par exemple :
    setx PATH "c:\local\mklml-2018.0.3\lib;%PATH%"
FACULTATIF : OpenCV

CNTK 2.2 nécessite l’installation d’Open Source Vision par ordinateur (OpenCV), mais elle est facultative pour CNTK 2.3+. Suivez cette page pour l’installer.

Vous devez installer OpenCV pour CNTK 2.3+ si vous souhaitez utiliser les composants suivants :

  • Lecteur d’images CNTK
  • CNTK Enregistreur d’images : requis pour utiliser la fonctionnalité Image de TensorBoard.

Ajoutez la variable PATH d’environnement pointant vers le dossier de build OpenCV, par exemple

setx PATH "C:\local\opencv3.10\build\x64\vc14\bin;%PATH%"

Installation d’exemples et de didacticiels

Nous fournissons différents exemples et tutoriels avec CNTK. Une fois que vous avez installé CNTK vous pouvez installer les exemples/didacticiels et les notebooks Jupyter. Si vous avez installé CNTK dans un environnement Python, veillez à activer l’environnement avant d’exécuter cette commande :

C:\> python -m cntk.sample_installer

Vous allez télécharger les exemples/didacticiels, installer les packages Python requis et copier les exemples dans un répertoire nommé CNTK-Samples-VERSION (VERSIONremplacé par la version réelle CNTK) sous votre répertoire de travail actuel.

Vous pouvez maintenant suivre la description standard pour tester votre installation à partir de Python et exécuter les didacticiels ou les notebooks Jupyter.