TensorFlow'u pip ile yükleyin

Bu kılavuz, TensorFlow'un en son kararlı sürümü içindir. Önizleme sürümü (nightly) için tf-nightly adlı pip paketini kullanın. Daha eski TensorFlow sürümlerinin gereksinimleri için bu tablolara bakın. Yalnızca CPU sürümü için tensorflow-cpu adlı pip paketini kullanın.

İşte kurulum komutlarının kısa versiyonları. Adım adım talimatlar için aşağı kaydırın.

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 Yerel

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

İşlemci

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

Gecelik

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

Donanım gereksinimleri

Aşağıdaki GPU özellikli cihazlar desteklenmektedir:

  • NVIDIA® GPU kartı, CUDA® mimarisi 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 ve üzeri sürümleri destekler. CUDA® özellikli GPU kartlarının listesine bakın.
  • Desteklenmeyen CUDA® mimarisine sahip GPU'lar için, PTX'ten JIT derlemesinden kaçınmak için veya NVIDIA® kütüphanelerinin farklı sürümlerini kullanmak için, kaynak koddan Linux derleme kılavuzuna bakın.
  • Paketler, en yeni desteklenen CUDA® mimarisi dışında PTX kodu içermez; bu nedenle, CUDA_FORCE_PTX_JIT=1 ayarı yapıldığında TensorFlow eski GPU'larda yüklenemez. (Ayrıntılar için Uygulama Uyumluluğu bölümüne bakın.)

Sistem gereksinimleri

  • Ubuntu 16.04 veya üzeri (64-bit)
  • macOS 12.0 (Monterey) veya üzeri (64 bit) (GPU desteği yok)
  • Windows Native - Windows 7 veya üzeri (64 bit) (TF 2.10'dan sonra GPU desteği yok)
  • Windows WSL2 - Windows 10 19044 veya üzeri (64 bit)

Yazılım gereksinimleri

Aşağıdaki NVIDIA® yazılımları yalnızca GPU desteği için gereklidir.

Adım adım talimatlar

Linux

1. Sistem gereksinimleri

  • Ubuntu 16.04 veya üzeri (64-bit)

TensorFlow resmi olarak yalnızca Ubuntu'yu desteklemektedir. Bununla birlikte, aşağıdaki talimatlar diğer Linux dağıtımları için de geçerli olabilir.

2. GPU kurulumu

TensorFlow'u yalnızca CPU üzerinde çalıştırıyorsanız bu bölümü atlayabilirsiniz.

Henüz yüklemediyseniz NVIDIA GPU sürücüsünü yükleyin. Yüklü olup olmadığını doğrulamak için aşağıdaki komutu kullanabilirsiniz.

nvidia-smi

3. venv kullanarak sanal bir ortam oluşturun.

`venv` modülü, Python'ın standart kütüphanesinin bir parçasıdır ve sanal ortamlar oluşturmanın resmi olarak önerilen yoludur.

İstediğiniz sanal ortamlar dizinine gidin ve aşağıdaki komutu kullanarak tf adında yeni bir venv ortamı oluşturun.

python3 -m venv tf 

Aşağıdaki komutla etkinleştirebilirsiniz.

source tf/bin/activate    

Kurulumun geri kalanında sanal ortamın etkinleştirildiğinden emin olun.

4. TensorFlow'u yükleyin.

TensorFlow, pip'in güncel bir sürümünü gerektirir; bu nedenle, en son sürümü kullandığınızdan emin olmak için pip kurulumunuzu güncelleyin.

pip install --upgrade pip

Ardından, pip kullanarak TensorFlow'u yükleyin.

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

6. Kurulumu doğrulayın.

İşlemci ayarlarını doğrulayın:

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

Bir tensör döndürülürse, TensorFlow'u başarıyla kurmuşsunuz demektir.

GPU ayarlarını doğrulayın:

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

GPU aygıtlarının bir listesi döndürülürse, TensorFlow'u başarıyla yüklemişsiniz demektir. Aksi takdirde bir sonraki adıma geçin .

6. [Yalnızca GPU] Sanal ortam yapılandırması

Son bölümdeki GPU testi başarısız olduysa, en olası neden bileşenlerin algılanmaması ve/veya mevcut sistem CUDA kurulumuyla çakışmasıdır. Bu nedenle, sorunu düzeltmek için bazı sembolik bağlantılar eklemeniz gerekir.

  • NVIDIA paylaşımlı kütüphanelerine sembolik bağlantılar oluşturun:
pushd $(dirname $(python -c 'print(__import__("tensorflow").__file__)'))
ln -svf ../nvidia/*/lib/*.so* .
popd
  • ptxas'a sembolik bir bağlantı oluşturun:
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

GPU ayarlarını doğrulayın:

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

MacOS

1. Sistem gereksinimleri

  • macOS 10.12.6 (Sierra) veya üzeri (64-bit)

Şu anda MacOS'ta TensorFlow çalıştırmak için resmi bir GPU desteği bulunmamaktadır. Aşağıdaki talimatlar CPU üzerinde çalıştırma içindir.

2. Python sürümünü kontrol edin.

Python ortamınızın zaten yapılandırılmış olup olmadığını kontrol edin:

python3 --version
python3 -m pip --version

3. TensorFlow'u yükleyin.

TensorFlow, pip'in güncel bir sürümünü gerektirir; bu nedenle, en son sürümü kullandığınızdan emin olmak için pip kurulumunuzu güncelleyin.

pip install --upgrade pip

Ardından, pip kullanarak TensorFlow'u yükleyin.

pip install tensorflow

4. Kurulumu doğrulayın.

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

Bir tensör döndürülürse, TensorFlow'u başarıyla kurmuşsunuz demektir.

Windows Yerel

1. Sistem gereksinimleri

  • Windows 7 veya üzeri (64 bit)

2. Microsoft Visual C++ Yeniden Dağıtılabilir Paketini Kurun

Visual Studio 2015, 2017 ve 2019 için Microsoft Visual C++ Yeniden Dağıtılabilir Paketini yükleyin. TensorFlow 2.1.0 sürümünden itibaren, bu paketten msvcp140_1.dll dosyası gereklidir (bu dosya daha eski yeniden dağıtılabilir paketlerde bulunmayabilir). Yeniden dağıtılabilir paket Visual Studio 2019 ile birlikte gelir, ancak ayrı olarak da yüklenebilir:

  1. Microsoft Visual C++ indirme sayfasına gidin.
  2. Sayfayı aşağı kaydırarak Visual Studio 2015, 2017 ve 2019 bölümüne ulaşın.
  3. Platformunuza uygun Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 ve 2019 paketini indirip kurun.

Windows'ta uzun dosya yollarının etkinleştirildiğinden emin olun.

3. Miniconda'yı yükleyin.

TensorFlow'u GPU desteğiyle kurmak için önerilen yöntem Miniconda'dır . Sisteminizde kurulu yazılımlarda herhangi bir değişiklik yapılmasını önlemek için ayrı bir ortam oluşturur. Ayrıca, özellikle GPU kurulumu için gerekli yazılımları kurmanın en kolay yoludur.

Miniconda Windows Installer dosyasını indirin. İndirilen dosyaya çift tıklayın ve ekrandaki yönergeleri izleyin.

4. Bir conda ortamı oluşturun.

Aşağıdaki komutu kullanarak tf adında yeni bir conda ortamı oluşturun.

conda create --name tf python=3.9

Aşağıdaki komutlarla devre dışı bırakabilir ve etkinleştirebilirsiniz.

conda deactivate
conda activate tf

Kurulumun geri kalanında etkinleştirildiğinden emin olun.

5. GPU kurulumu

TensorFlow'u yalnızca CPU üzerinde çalıştırıyorsanız bu bölümü atlayabilirsiniz.

Öncelikle, henüz yüklemediyseniz NVIDIA GPU sürücüsünü yükleyin.

Ardından conda kullanarak CUDA ve cuDNN'i kurun.

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

6. TensorFlow'u yükleyin.

TensorFlow, pip'in güncel bir sürümünü gerektirir; bu nedenle, en son sürümü kullandığınızdan emin olmak için pip kurulumunuzu güncelleyin.

pip install --upgrade pip

Ardından, pip kullanarak TensorFlow'u yükleyin.

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

7. Kurulumu doğrulayın.

İşlemci ayarlarını doğrulayın:

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

Bir tensör döndürülürse, TensorFlow'u başarıyla kurmuşsunuz demektir.

GPU ayarlarını doğrulayın:

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

GPU aygıtlarının bir listesi görüntülenirse, TensorFlow'u başarıyla yüklemişsiniz demektir.

Windows WSL2

1. Sistem gereksinimleri

  • Windows 10 19044 veya üzeri (64 bit). Bu, Kasım 2021 güncellemesi olan Windows 10 sürüm 21H2'ye karşılık gelir.

Aşağıdaki belgelere bakınız:

2. GPU kurulumu

TensorFlow'u yalnızca CPU üzerinde çalıştırıyorsanız bu bölümü atlayabilirsiniz.

Henüz yüklemediyseniz NVIDIA GPU sürücüsünü yükleyin. Yüklü olup olmadığını doğrulamak için aşağıdaki komutu kullanabilirsiniz.

nvidia-smi

3. TensorFlow'u yükleyin.

TensorFlow, pip'in güncel bir sürümünü gerektirir; bu nedenle, en son sürümü kullandığınızdan emin olmak için pip kurulumunuzu güncelleyin.

pip install --upgrade pip

Ardından, pip kullanarak TensorFlow'u yükleyin.

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

4. Kurulumu doğrulayın.

İşlemci ayarlarını doğrulayın:

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

Bir tensör döndürülürse, TensorFlow'u başarıyla kurmuşsunuz demektir.

GPU ayarlarını doğrulayın:

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

GPU aygıtlarının bir listesi görüntülenirse, TensorFlow'u başarıyla yüklemişsiniz demektir.

Paket konumu

Bazı kurulum mekanizmaları TensorFlow Python paketinin URL'sini gerektirir. Belirttiğiniz değer Python sürümünüze bağlıdır.

Python sürüm desteği

Sürüm URL
Linux x86
Python 3.10 GPU desteği 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-only https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp310-cp310-manylinux_2_27_x86_64.whl
Python 3.11 GPU desteği 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-only https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp311-cp311-manylinux_2_27_x86_64.whl
Python 3.12 GPU desteği 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-only 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
Python 3.13 GPU desteği 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-only 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 (yalnızca 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 (yalnızca CPU)
Uyarı : TensorFlow 2.16, macOS x86'yı destekleyen son TensorFlow sürümüydü.
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 (yalnızca 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 (yalnızca 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