Installa TensorFlow con pip

Questa guida è valida per l'ultima versione stabile di TensorFlow. Per la build di anteprima (nightly) , utilizzare il pacchetto pip denominato tf-nightly . Consultare queste tabelle per i requisiti delle versioni precedenti di TensorFlow. Per la build solo CPU, utilizzare il pacchetto pip denominato tensorflow-cpu .

Ecco le versioni rapide dei comandi di installazione. Scorri verso il basso per le istruzioni dettagliate.

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 nativo

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'))"

processore

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

Ogni notte

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

Requisiti hardware

Sono supportati i seguenti dispositivi dotati di GPU:

  • Scheda GPU NVIDIA® con architetture CUDA® 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 e successive. Consulta l'elenco delle schede GPU compatibili con CUDA® .
  • Per le GPU con architetture CUDA® non supportate, per evitare la compilazione JIT da PTX o per utilizzare versioni diverse delle librerie NVIDIA®, consultare la guida alla compilazione da sorgente per Linux .
  • I pacchetti non contengono codice PTX, ad eccezione dell'architettura CUDA® più recente supportata; pertanto, TensorFlow non si carica sulle GPU meno recenti quando è impostato CUDA_FORCE_PTX_JIT=1 . (Vedere Compatibilità delle applicazioni per ulteriori dettagli.)

Requisiti di sistema

  • Ubuntu 16.04 o superiore (64 bit)
  • macOS 12.0 (Monterey) o superiore (64 bit) (nessun supporto GPU)
  • Supporto nativo per Windows - Windows 7 o versioni successive (64 bit) (nessun supporto GPU dopo TensorFlow 2.10)
  • Windows WSL2 - Windows 10 19044 o versioni successive (64 bit)

Requisiti software

I seguenti software NVIDIA® sono necessari solo per il supporto della GPU.

Istruzioni passo passo

Linux

1. Requisiti di sistema

  • Ubuntu 16.04 o superiore (64 bit)

TensorFlow supporta ufficialmente solo Ubuntu. Tuttavia, le seguenti istruzioni potrebbero funzionare anche per altre distribuzioni Linux.

2. Configurazione della GPU

Puoi saltare questa sezione se esegui TensorFlow solo sulla CPU.

Installa il driver della GPU NVIDIA se non lo hai già fatto. Puoi utilizzare il seguente comando per verificare che sia installato.

nvidia-smi

3. Crea un ambiente virtuale con venv

Il modulo venv fa parte della libreria standard di Python ed è il metodo ufficialmente raccomandato per creare ambienti virtuali.

Accedi alla directory degli ambienti virtuali desiderata e crea un nuovo ambiente venv denominato tf con il seguente comando.

python3 -m venv tf 

È possibile attivarlo con il seguente comando.

source tf/bin/activate    

Assicurati che l'ambiente virtuale sia attivato per il resto dell'installazione.

4. Installa TensorFlow

TensorFlow richiede una versione recente di pip, quindi aggiorna l'installazione di pip per assicurarti di utilizzare la versione più recente.

pip install --upgrade pip

Successivamente, installa TensorFlow con pip.

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

6. Verificare l'installazione

Verifica la configurazione della CPU:

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

Se viene restituito un tensore, l'installazione di TensorFlow è andata a buon fine.

Verifica la configurazione della GPU:

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

Se viene visualizzato un elenco di dispositivi GPU, l'installazione di TensorFlow è andata a buon fine. In caso contrario, procedere al passaggio successivo .

6. [Solo GPU] Configurazione dell'ambiente virtuale

Se il test della GPU nella sezione precedente non ha avuto successo, la causa più probabile è che i componenti non vengano rilevati e/o che vi sia un conflitto con l'installazione CUDA del sistema. Pertanto, è necessario aggiungere dei collegamenti simbolici per risolvere il problema.

  • Crea collegamenti simbolici alle librerie condivise di NVIDIA:
pushd $(dirname $(python -c 'print(__import__("tensorflow").__file__)'))
ln -svf ../nvidia/*/lib/*.so* .
popd
  • Crea un collegamento simbolico a 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

Verifica la configurazione della GPU:

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

MacOS

1. Requisiti di sistema

  • macOS 10.12.6 (Sierra) o versioni successive (64 bit)

Al momento non esiste un supporto ufficiale per GPU per l'esecuzione di TensorFlow su macOS. Le seguenti istruzioni si riferiscono all'esecuzione su CPU.

2. Verifica la versione di Python

Controlla se il tuo ambiente Python è già configurato:

python3 --version
python3 -m pip --version

3. Installa TensorFlow

TensorFlow richiede una versione recente di pip, quindi aggiorna l'installazione di pip per assicurarti di utilizzare la versione più recente.

pip install --upgrade pip

Successivamente, installa TensorFlow con pip.

pip install tensorflow

4. Verificare l'installazione

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

Se viene restituito un tensore, l'installazione di TensorFlow è andata a buon fine.

Windows nativo

1. Requisiti di sistema

  • Windows 7 o versioni successive (64 bit)

2. Installare Microsoft Visual C++ Redistributable

Installare il pacchetto ridistribuibile di Microsoft Visual C++ per Visual Studio 2015, 2017 e 2019. A partire dalla versione TensorFlow 2.1.0, è necessario il file msvcp140_1.dll presente in questo pacchetto (che potrebbe non essere incluso nei pacchetti ridistribuibili precedenti). Il pacchetto ridistribuibile è incluso in Visual Studio 2019 , ma può essere installato anche separatamente.

  1. Vai alla pagina di download di Microsoft Visual C++ .
  2. Scorri la pagina verso il basso fino alla sezione Visual Studio 2015, 2017 e 2019 .
  3. Scarica e installa il pacchetto ridistribuibile di Microsoft Visual C++ per Visual Studio 2015, 2017 e 2019 per la tua piattaforma.

Assicurati che i percorsi lunghi siano abilitati in Windows.

3. Installa Miniconda

Miniconda è il metodo consigliato per installare TensorFlow con supporto GPU. Crea un ambiente separato per evitare di modificare qualsiasi software già installato sul sistema. Questo è anche il modo più semplice per installare il software necessario, soprattutto per la configurazione GPU.

Scarica il programma di installazione di Miniconda per Windows . Fai doppio clic sul file scaricato e segui le istruzioni visualizzate sullo schermo.

4. Creare un ambiente conda

Crea un nuovo ambiente conda chiamato tf con il seguente comando.

conda create --name tf python=3.9

È possibile disattivarlo e attivarlo con i seguenti comandi.

conda deactivate
conda activate tf

Assicurati che sia attivato per il resto dell'installazione.

5. Configurazione della GPU

Puoi saltare questa sezione se esegui TensorFlow solo sulla CPU.

Innanzitutto, installa i driver della GPU NVIDIA se non li hai già installati.

Successivamente, installa CUDA e cuDNN tramite conda.

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

6. Installa TensorFlow

TensorFlow richiede una versione recente di pip, quindi aggiorna l'installazione di pip per assicurarti di utilizzare la versione più recente.

pip install --upgrade pip

Successivamente, installa TensorFlow con pip.

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

7. Verificare l'installazione

Verifica la configurazione della CPU:

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

Se viene restituito un tensore, l'installazione di TensorFlow è andata a buon fine.

Verifica la configurazione della GPU:

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

Se viene visualizzato un elenco di dispositivi GPU, l'installazione di TensorFlow è andata a buon fine.

Windows WSL2

1. Requisiti di sistema

  • Windows 10 versione 19044 o superiore (64 bit). Ciò corrisponde a Windows 10 versione 21H2, l'aggiornamento di novembre 2021.

Consultare i seguenti documenti per:

2. Configurazione della GPU

Puoi saltare questa sezione se esegui TensorFlow solo sulla CPU.

Installa il driver della GPU NVIDIA se non lo hai già fatto. Puoi utilizzare il seguente comando per verificare che sia installato.

nvidia-smi

3. Installa TensorFlow

TensorFlow richiede una versione recente di pip, quindi aggiorna l'installazione di pip per assicurarti di utilizzare la versione più recente.

pip install --upgrade pip

Successivamente, installa TensorFlow con pip.

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

4. Verificare l'installazione

Verifica la configurazione della CPU:

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

Se viene restituito un tensore, l'installazione di TensorFlow è andata a buon fine.

Verifica la configurazione della GPU:

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

Se viene visualizzato un elenco di dispositivi GPU, l'installazione di TensorFlow è andata a buon fine.

Posizione del pacco

Alcuni meccanismi di installazione richiedono l'URL del pacchetto Python di TensorFlow. Il valore da specificare dipende dalla versione di Python in uso.

Supporto per la versione di Python

Versione URL
Linux x86
Supporto GPU per 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 solo CPU https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp310-cp310-manylinux_2_27_x86_64.whl
Supporto GPU per 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 Solo CPU https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp311-cp311-manylinux_2_27_x86_64.whl
Supporto GPU per 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 Solo CPU 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
Supporto GPU per 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 Solo CPU 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 (solo CPU)
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 (solo CPU)
Attenzione : TensorFlow 2.16 è stata l' ultima versione di TensorFlow a supportare 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 (solo CPU)
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 (solo CPU)
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