Installer TensorFlow avec pip

Ce guide concerne la dernière version stable de TensorFlow. Pour la version préliminaire (nightly) , utilisez le package pip nommé tf-nightly . Consultez ces tableaux pour connaître les exigences des versions antérieures de TensorFlow. Pour la version fonctionnant uniquement sur le processeur, utilisez le package pip nommé tensorflow-cpu .

Voici les versions abrégées des commandes d'installation. Faites défiler vers le bas pour les instructions détaillées.

Linux

python3 -m pip install 'tensorflow[and-cuda]'
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

macOS

# There is currently no official GPU support for MacOS.
python3 -m pip install tensorflow
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Windows natif

conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0
# Anything above 2.10 is not supported on the GPU on Windows Native
python -m pip install "tensorflow<2.11"
# Verify the installation:
python -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

Windows WSL2

python3 -m pip install tensorflow[and-cuda]
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

processeur

python3 -m pip install tensorflow
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Chaque nuit

python3 -m pip install tf-nightly
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Exigences matérielles

Les périphériques compatibles avec le GPU suivants sont pris en charge :

  • Carte graphique NVIDIA® compatible avec les architectures CUDA® 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 et supérieures. Consultez la liste des cartes graphiques compatibles CUDA® .
  • Pour les GPU dotés d'architectures CUDA® non prises en charge, ou pour éviter la compilation JIT à partir de PTX, ou pour utiliser des versions différentes des bibliothèques NVIDIA®, consultez le guide de compilation à partir des sources Linux .
  • Les packages ne contiennent pas de code PTX, sauf pour la dernière architecture CUDA® prise en charge ; par conséquent, TensorFlow ne peut pas se charger sur les GPU plus anciens lorsque CUDA_FORCE_PTX_JIT=1 est défini. (Voir la section Compatibilité des applications pour plus de détails.)

Configuration système requise

  • Ubuntu 16.04 ou supérieur (64 bits)
  • macOS 12.0 (Monterey) ou supérieur (64 bits) (sans prise en charge GPU)
  • Windows natif - Windows 7 ou supérieur (64 bits) (pas de prise en charge GPU après TF 2.10)
  • Windows WSL2 - Windows 10 19044 ou version ultérieure (64 bits)

Exigences logicielles

Les logiciels NVIDIA® suivants sont uniquement requis pour la prise en charge du GPU.

Instructions étape par étape

Linux

1. Configuration système requise

  • Ubuntu 16.04 ou supérieur (64 bits)

TensorFlow ne prend officiellement en charge qu'Ubuntu. Cependant, les instructions suivantes peuvent également fonctionner pour d'autres distributions Linux.

2. Configuration du GPU

Vous pouvez ignorer cette section si vous exécutez TensorFlow uniquement sur le processeur.

Installez le pilote de votre carte graphique NVIDIA si ce n'est pas déjà fait. Vous pouvez utiliser la commande suivante pour vérifier son installation.

nvidia-smi

3. Créez un environnement virtuel avec venv

Le module venv fait partie de la bibliothèque standard de Python et constitue la méthode officiellement recommandée pour créer des environnements virtuels.

Accédez au répertoire de vos environnements virtuels souhaités et créez un nouvel environnement venv nommé tf avec la commande suivante.

python3 -m venv tf 

Vous pouvez l'activer avec la commande suivante.

source tf/bin/activate    

Assurez-vous que l'environnement virtuel est activé pour le reste de l'installation.

4. Installez TensorFlow

TensorFlow nécessite une version récente de pip ; mettez donc à jour votre installation de pip pour vous assurer d'utiliser la dernière version.

pip install --upgrade pip

Ensuite, installez TensorFlow avec pip.

# For GPU users
pip install tensorflow[and-cuda]
# For CPU users
pip install tensorflow

6. Vérifiez l'installation

Vérifiez la configuration du processeur :

python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Si un tenseur est renvoyé, cela signifie que vous avez installé TensorFlow avec succès.

Vérifiez la configuration du GPU :

python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

Si une liste de périphériques GPU s'affiche, TensorFlow est installé avec succès. Sinon, passez à l'étape suivante .

6. [GPU uniquement] Configuration de l'environnement virtuel

Si le test GPU de la section précédente a échoué, la cause la plus probable est que certains composants ne sont pas détectés et/ou qu'il y a un conflit avec l'installation CUDA existante du système. Il vous faut donc ajouter des liens symboliques pour résoudre ce problème.

  • Créer des liens symboliques vers les bibliothèques partagées NVIDIA :
pushd $(dirname $(python -c 'print(__import__("tensorflow").__file__)'))
ln -svf ../nvidia/*/lib/*.so* .
popd
  • Créez un lien symbolique vers ptxas :
ln -sf $(find $(dirname $(dirname $(python -c "import nvidia.cuda_nvcc;         
print(nvidia.cuda_nvcc.__file__)"))/*/bin/) -name ptxas -print -quit) $VIRTUAL_ENV/bin/ptxas

Vérifiez la configuration du GPU :

python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

macOS

1. Configuration système requise

  • macOS 10.12.6 (Sierra) ou version ultérieure (64 bits)

Actuellement, TensorFlow ne prend pas officiellement en charge les GPU sous macOS. Les instructions suivantes concernent son exécution sur CPU.

2. Vérifier la version de Python

Vérifiez si votre environnement Python est déjà configuré :

python3 --version
python3 -m pip --version

3. Installez TensorFlow

TensorFlow nécessite une version récente de pip ; mettez donc à jour votre installation de pip pour vous assurer d'utiliser la dernière version.

pip install --upgrade pip

Ensuite, installez TensorFlow avec pip.

pip install tensorflow

4. Vérifiez l'installation

python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Si un tenseur est renvoyé, cela signifie que vous avez installé TensorFlow avec succès.

Windows natif

1. Configuration système requise

  • Windows 7 ou version ultérieure (64 bits)

2. Installez Microsoft Visual C++ Redistributable

Installez le package redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017 et 2019. À partir de la version TensorFlow 2.1.0, le fichier msvcp140_1.dll est requis (il peut ne pas être fourni par les packages redistribuables plus anciens). Ce package est inclus dans Visual Studio 2019 , mais peut également être installé séparément.

  1. Rendez-vous sur la page de téléchargement de Microsoft Visual C++ .
  2. Faites défiler la page vers le bas jusqu'à la section Visual Studio 2015, 2017 et 2019 .
  3. Téléchargez et installez le package redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017 et 2019 pour votre plateforme.

Assurez-vous que les chemins d'accès longs sont activés sous Windows.

3. Installez Miniconda

Miniconda est la méthode recommandée pour installer TensorFlow avec prise en charge du GPU. Elle crée un environnement distinct afin de ne pas modifier les logiciels déjà installés sur votre système. C'est également la méthode la plus simple pour installer les logiciels nécessaires, notamment pour la configuration GPU.

Téléchargez le programme d'installation Miniconda pour Windows . Double-cliquez sur le fichier téléchargé et suivez les instructions à l'écran.

4. Créer un environnement conda

Créez un nouvel environnement conda nommé tf avec la commande suivante.

conda create --name tf python=3.9

Vous pouvez le désactiver et l'activer à l'aide des commandes suivantes.

conda deactivate
conda activate tf

Assurez-vous qu'elle soit activée pour le reste de l'installation.

5. Configuration du GPU

Vous pouvez ignorer cette section si vous exécutez TensorFlow uniquement sur le processeur.

Commencez par installer le pilote de votre carte graphique NVIDIA si ce n'est pas déjà fait.

Installez ensuite CUDA et cuDNN avec conda.

conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0

6. Installez TensorFlow

TensorFlow nécessite une version récente de pip ; mettez donc à jour votre installation de pip pour vous assurer d'utiliser la dernière version.

pip install --upgrade pip

Ensuite, installez TensorFlow avec pip.

# Anything above 2.10 is not supported on the GPU on Windows Native
pip install "tensorflow<2.11" 

7. Vérifiez l'installation

Vérifiez la configuration du processeur :

python -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Si un tenseur est renvoyé, cela signifie que vous avez installé TensorFlow avec succès.

Vérifiez la configuration du GPU :

python -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

Si une liste de périphériques GPU est renvoyée, cela signifie que vous avez installé TensorFlow avec succès.

Windows WSL2

1. Configuration système requise

  • Windows 10 version 19044 ou ultérieure (64 bits). Cela correspond à la version 21H2 de Windows 10, la mise à jour de novembre 2021.

Consultez les documents suivants pour :

2. Configuration du GPU

Vous pouvez ignorer cette section si vous exécutez TensorFlow uniquement sur le processeur.

Installez le pilote de votre carte graphique NVIDIA si ce n'est pas déjà fait. Vous pouvez utiliser la commande suivante pour vérifier son installation.

nvidia-smi

3. Installez TensorFlow

TensorFlow nécessite une version récente de pip ; mettez donc à jour votre installation de pip pour vous assurer d'utiliser la dernière version.

pip install --upgrade pip

Ensuite, installez TensorFlow avec pip.

# For GPU users
pip install tensorflow[and-cuda]
# For CPU users
pip install tensorflow

4. Vérifiez l'installation

Vérifiez la configuration du processeur :

python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"

Si un tenseur est renvoyé, cela signifie que vous avez installé TensorFlow avec succès.

Vérifiez la configuration du GPU :

python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"

Si une liste de périphériques GPU est renvoyée, cela signifie que vous avez installé TensorFlow avec succès.

Emplacement du colis

Certains mécanismes d'installation requièrent l'URL du package Python TensorFlow. La valeur à spécifier dépend de votre version de Python.

Prise en charge des versions de Python

Version URL
Linux x86
Prise en charge GPU de Python 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-manylinux_2_27_x86_64.whl
Python 3.10 (CPU uniquement) https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp310-cp310-manylinux_2_27_x86_64.whl
Prise en charge GPU de Python 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-manylinux_2_27_x86_64.whl
Python 3.11 (CPU uniquement) https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp311-cp311-manylinux_2_27_x86_64.whl
Prise en charge GPU de Python 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-manylinux_2_27_x86_64.whl
Python 3.12 (CPU uniquement) https://storage.googleapis.com/tensorflow/versions/2.20.0/tensorflow_cpu-2.20.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Prise en charge GPU de Python 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-manylinux_2_27_x86_64.whl
Python 3.13 (CPU uniquement) https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp313-cp313-manylinux_2_27_x86_64.whl
Linux Arm64 (CPU uniquement)
Python 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-manylinux_2_27_aarch64.whl
Python 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-manylinux_2_27_aarch64.whl
Python 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-manylinux_2_27_aarch64.whl
Python 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-manylinux_2_27_aarch64.whl
macOS x86 (CPU uniquement)
Attention : TensorFlow 2.16 était la dernière version de TensorFlow compatible avec macOS x86.
Python 3.10 https://storage.googleapis.com/tensorflow/versions/2.16.2/tensorflow-2.16.2-cp310-cp310-macosx_10_15_x86_64.whl
Python 3.11 https://storage.googleapis.com/tensorflow/versions/2.16.2/tensorflow-2.16.2-cp311-cp311-macosx_10_15_x86_64.whl
Python 3.12 https://storage.googleapis.com/tensorflow/versions/2.16.2/tensorflow-2.16.2-cp312-cp312-macosx_10_15_x86_64.whl
macOS Arm64 (CPU uniquement)
Python 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-macosx_12_0_arm64.whl
Python 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-macosx_12_0_arm64.whl
Python 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-macosx_12_0_arm64.whl
Python 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-macosx_12_0_arm64.whl
Windows (processeur uniquement)
Python 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-win_amd64.whl
Python 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-win_amd64.whl
Python 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-win_amd64.whl
Python 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-win_amd64.whl