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=1ayarı 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
- Python 3.9–3.12
- Linux (
manylinux2014desteği gerektirir) ve Windows için pip sürüm 19.0 veya üzeri; macOS için pip sürüm 20.3 veya üzeri gereklidir. - Windows için yerel olarak çalışır ve Visual Studio 2015, 2017 ve 2019 için Microsoft Visual C++ Yeniden Dağıtılabilir paketini gerektirir.
Aşağıdaki NVIDIA® yazılımları yalnızca GPU desteği için gereklidir.
- NVIDIA® GPU sürücüleri
- Linux için >= 525.60.13
- Windows'ta WSL için >= 528.33
- CUDA® Araç Seti 12.3 .
- cuDNN SDK 8.9.7 .
- (İsteğe bağlı) Çıkarım işlemlerinde gecikmeyi ve verimliliği artırmak için TensorRT kullanılabilir .
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:
- Microsoft Visual C++ indirme sayfasına gidin.
- Sayfayı aşağı kaydırarak Visual Studio 2015, 2017 ve 2019 bölümüne ulaşın.
- 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.