Este guia é para a versão estável mais recente do TensorFlow. Para a versão de pré-visualização (nightly) , use o pacote pip chamado tf-nightly
. Consulte estas tabelas para ver os requisitos de versões mais antigas do TensorFlow. Para a versão somente para CPU, use o pacote pip chamado tensorflow-cpu
.
Aqui estão as versões rápidas dos comandos de instalação. Role para baixo para ver as instruções passo a passo.
Linux
python3 -m pip install 'tensorflow[and-cuda]'
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"
Mac OS
# 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])))"
Nativo do Windows
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'))"
CPU
python3 -m pip install tensorflow
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Noturno
python3 -m pip install tf-nightly
# Verify the installation:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Requisitos de hardware
Os seguintes dispositivos habilitados para GPU são suportados:
- Placa de GPU NVIDIA® com arquiteturas CUDA® 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 e superiores. Veja a lista de placas de GPU compatíveis com CUDA® .
- Para GPUs com arquiteturas CUDA® não suportadas, ou para evitar a compilação JIT do PTX, ou para usar versões diferentes das bibliotecas NVIDIA®, consulte o guia de compilação do Linux a partir da fonte .
- Os pacotes não contêm código PTX, exceto para a arquitetura CUDA® mais recente com suporte; portanto, o TensorFlow não carrega em GPUs mais antigas quando
CUDA_FORCE_PTX_JIT=1
é definido. (Consulte Compatibilidade de Aplicativos para obter detalhes.)
Requisitos do sistema
- Ubuntu 16.04 ou superior (64 bits)
- macOS 12.0 (Monterey) ou superior (64 bits) (sem suporte a GPU)
- Nativo do Windows - Windows 7 ou superior (64 bits) (sem suporte para GPU após o TF 2.10)
- Windows WSL2 - Windows 10 19044 ou superior (64 bits)
Requisitos de software
- Python 3.9–3.12
- pip versão 19.0 ou superior para Linux (requer suporte
manylinux2014
) e Windows. pip versão 20.3 ou superior para macOS. - O Windows Native requer o Microsoft Visual C++ Redistributable para o Visual Studio 2015, 2017 e 2019
Os seguintes softwares NVIDIA® são necessários apenas para suporte à GPU.
- Drivers de GPU NVIDIA®
- >= 525.60.13 para Linux
- >= 528,33 para WSL no Windows
- Kit de ferramentas CUDA® 12.3 .
- SDK cuDNN 8.9.7 .
- (Opcional) TensorRT para melhorar a latência e a taxa de transferência para inferência.
Instruções passo a passo
Linux
1. Requisitos do sistema
- Ubuntu 16.04 ou superior (64 bits)
O TensorFlow oferece suporte oficial apenas ao Ubuntu. No entanto, as instruções a seguir também podem funcionar para outras distribuições Linux.
2. Configuração da GPU
Você pode pular esta seção se executar apenas o TensorFlow na CPU.
Instale o driver da GPU NVIDIA, caso ainda não tenha. Você pode usar o seguinte comando para verificar se ele está instalado.
nvidia-smi
3. Crie um ambiente virtual com venv
O módulo venv faz parte da biblioteca padrão do Python e é a maneira oficialmente recomendada de criar ambientes virtuais.
Navegue até o diretório de ambientes virtuais desejado e crie um novo ambiente venv chamado tf
com o seguinte comando.
python3 -m venv tf
Você pode ativá-lo com o seguinte comando.
source tf/bin/activate
Certifique-se de que o ambiente virtual esteja ativado para o restante da instalação.
4. Instale o TensorFlow
O TensorFlow requer uma versão recente do pip, então atualize sua instalação do pip para ter certeza de que está executando a versão mais recente.
pip install --upgrade pip
Em seguida, instale o TensorFlow com pip.
# For GPU users
pip install tensorflow[and-cuda]
# For CPU users
pip install tensorflow
6. Verifique a instalação
Verifique a configuração da CPU:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Se um tensor for retornado, você instalou o TensorFlow com sucesso.
Verifique a configuração da GPU:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"
Se uma lista de dispositivos GPU for retornada, você instalou o TensorFlow com sucesso. Caso contrário, continue para a próxima etapa .
6. [Somente GPU] Configuração do ambiente virtual
Se o teste de GPU da última seção não tiver sido bem-sucedido, a causa mais provável é que os componentes não estejam sendo detectados e/ou entrem em conflito com a instalação CUDA do sistema existente. Portanto, você precisa adicionar alguns links simbólicos para corrigir isso.
- Crie links simbólicos para bibliotecas compartilhadas da NVIDIA:
pushd $(dirname $(python -c 'print(__import__("tensorflow").__file__)'))
ln -svf ../nvidia/*/lib/*.so* .
popd
- Crie um link simbólico para 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
Verifique a configuração da GPU:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"
Mac OS
1. Requisitos do sistema
- macOS 10.12.6 (Sierra) ou superior (64 bits)
Atualmente, não há suporte oficial de GPU para executar o TensorFlow no macOS. As instruções a seguir são para execução na CPU.
2. Verifique a versão do Python
Verifique se seu ambiente Python já está configurado:
python3 --version
python3 -m pip --version
3. Instale o TensorFlow
O TensorFlow requer uma versão recente do pip, então atualize sua instalação do pip para ter certeza de que está executando a versão mais recente.
pip install --upgrade pip
Em seguida, instale o TensorFlow com pip.
pip install tensorflow
4. Verifique a instalação
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Se um tensor for retornado, você instalou o TensorFlow com sucesso.
Nativo do Windows
1. Requisitos do sistema
- Windows 7 ou superior (64 bits)
2. Instale o Microsoft Visual C++ Redistributable
Instale o Microsoft Visual C++ Redistributable para o Visual Studio 2015, 2017 e 2019. A partir da versão 2.1.0 do TensorFlow, o arquivo msvcp140_1.dll
é necessário neste pacote (que pode não ser fornecido por pacotes redistribuíveis mais antigos). O redistribuível vem com o Visual Studio 2019 , mas pode ser instalado separadamente:
- Acesse os downloads do Microsoft Visual C++ .
- Role a página para baixo até a seção Visual Studio 2015, 2017 e 2019 .
- Baixe e instale o Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017 e 2019 para sua plataforma.
Certifique-se de que caminhos longos estejam habilitados no Windows.
3. Instale o Miniconda
O Miniconda é a abordagem recomendada para instalar o TensorFlow com suporte à GPU. Ele cria um ambiente separado para evitar alterações em qualquer software instalado no seu sistema. Esta também é a maneira mais fácil de instalar o software necessário, especialmente para a configuração da GPU.
Baixe o instalador do Miniconda para Windows . Clique duas vezes no arquivo baixado e siga as instruções na tela.
4. Crie um ambiente conda
Crie um novo ambiente conda chamado tf
com o seguinte comando.
conda create --name tf python=3.9
Você pode desativá-lo e ativá-lo com os seguintes comandos.
conda deactivate
conda activate tf
Certifique-se de que ele esteja ativado para o restante da instalação.
5. Configuração da GPU
Você pode pular esta seção se executar o TensorFlow apenas na CPU.
Primeiro instale o driver da GPU NVIDIA, caso ainda não tenha feito isso.
Em seguida, instale o CUDA, cuDNN com conda.
conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0
6. Instale o TensorFlow
O TensorFlow requer uma versão recente do pip, então atualize sua instalação do pip para ter certeza de que está executando a versão mais recente.
pip install --upgrade pip
Em seguida, instale o TensorFlow com pip.
# Anything above 2.10 is not supported on the GPU on Windows Native
pip install "tensorflow<2.11"
7. Verifique a instalação
Verifique a configuração da CPU:
python -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Se um tensor for retornado, você instalou o TensorFlow com sucesso.
Verifique a configuração da GPU:
python -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"
Se uma lista de dispositivos GPU for retornada, você instalou o TensorFlow com sucesso.
Windows WSL2
1. Requisitos do sistema
- Windows 10 19044 ou superior (64 bits). Isso corresponde à versão 21H2 do Windows 10, atualização de novembro de 2021.
Consulte os seguintes documentos para:
- Baixe a atualização mais recente do Windows 10 .
- Instalar WSL2
- Configurar suporte à GPU NVIDIA® no WSL2
2. Configuração da GPU
Você pode pular esta seção se executar apenas o TensorFlow na CPU.
Instale o driver da GPU NVIDIA, caso ainda não tenha. Você pode usar o seguinte comando para verificar se ele está instalado.
nvidia-smi
3. Instale o TensorFlow
O TensorFlow requer uma versão recente do pip, então atualize sua instalação do pip para ter certeza de que está executando a versão mais recente.
pip install --upgrade pip
Em seguida, instale o TensorFlow com pip.
# For GPU users
pip install tensorflow[and-cuda]
# For CPU users
pip install tensorflow
4. Verifique a instalação
Verifique a configuração da CPU:
python3 -c "import tensorflow as tf; print(tf.reduce_sum(tf.random.normal([1000, 1000])))"
Se um tensor for retornado, você instalou o TensorFlow com sucesso.
Verifique a configuração da GPU:
python3 -c "import tensorflow as tf; print(tf.config.list_physical_devices('GPU'))"
Se uma lista de dispositivos GPU for retornada, você instalou o TensorFlow com sucesso.
Localização do pacote
Alguns mecanismos de instalação exigem a URL do pacote Python do TensorFlow. O valor especificado depende da sua versão do Python.