התקן את TensorFlow עם pip

מדריך זה מיועד לגרסה היציבה האחרונה של TensorFlow. עבור גרסת התצוגה המקדימה (nightly) , השתמש בחבילת pip בשם tf-nightly . עיין בטבלאות אלה עבור דרישות גרסאות ישנות יותר של TensorFlow. עבור גרסת ה-CPU בלבד, השתמש בחבילת pip בשם tensorflow-cpu .

הנה הגרסאות המהירות של פקודות ההתקנה. גלול מטה לקבלת הוראות שלב אחר שלב.

לינוקס

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

מק 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])))"

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

מעבד

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

לֵילִי

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

דרישות חומרה

המכשירים הבאים התומכים ב-GPU נתמכים:

  • כרטיס GPU של NVIDIA®‎ עם ארכיטקטורות CUDA®‎ 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 ומעלה. עיין ברשימת כרטיסי GPU התומכים ב-CUDA® ‎.
  • עבור מעבדים גרפיים עם ארכיטקטורות CUDA® שאינן נתמכות, או כדי להימנע מהידור JIT מ-PTX, או כדי להשתמש בגרסאות שונות של ספריות NVIDIA®, עיינו במדריך לבנייה של לינוקס ממקור .
  • חבילות אינן מכילות קוד PTX למעט ארכיטקטורת CUDA® הנתמכת העדכנית ביותר; לכן, TensorFlow נכשל בטעינה על מעבדים גרפיים ישנים יותר כאשר CUDA_FORCE_PTX_JIT=1 מוגדר. (ראה תאימות יישומים לפרטים.)

דרישות המערכת

  • אובונטו 16.04 ומעלה (64 סיביות)
  • macOS 12.0 (מונטריי) ומעלה (64 סיביות) (אין תמיכה ב-GPU)
  • Windows Native - Windows 7 ומעלה (64 סיביות) (אין תמיכה ב-GPU לאחר TF 2.10)
  • Windows WSL2 - Windows 10 19044 ומעלה (64 סיביות)

דרישות תוכנה

תוכנות NVIDIA® הבאות נדרשות רק לתמיכה ב-GPU.

הוראות שלב אחר שלב

לינוקס

1. דרישות מערכת

  • אובונטו 16.04 ומעלה (64 סיביות)

TensorFlow תומך רשמית רק באובונטו. עם זאת, ההוראות הבאות עשויות לעבוד גם עבור הפצות לינוקס אחרות.

2. הגדרת כרטיס מסך

ניתן לדלג על סעיף זה אם אתם מפעילים את TensorFlow רק על המעבד.

התקן את מנהל ההתקן של כרטיס המסך של NVIDIA אם עדיין לא עשית זאת. באפשרותך להשתמש בפקודה הבאה כדי לוודא שהוא מותקן.

nvidia-smi

3. צור סביבה וירטואלית עם venv

מודול venv הוא חלק מספריית הסטנדרט של פייתון והוא הדרך המומלצת רשמית ליצירת סביבות וירטואליות.

נווטו לספריית הסביבות הווירטואליות הרצויה וצרו סביבת venv חדשה בשם tf באמצעות הפקודה הבאה.

python3 -m venv tf 

ניתן להפעיל אותו באמצעות הפקודה הבאה.

source tf/bin/activate    

ודא שהסביבה הווירטואלית מופעלת למשך שאר ההתקנה.

4. התקנת TensorFlow

TensorFlow דורש גרסה עדכנית של pip, לכן שדרגו את התקנת ה-pip שלכם כדי לוודא שאתם מפעילים את הגרסה העדכנית ביותר.

pip install --upgrade pip

לאחר מכן, התקן את TensorFlow באמצעות pip.

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

6. אימות ההתקנה

בדוק את הגדרת המעבד:

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

אם מוחזר טנזור, התקנת את TensorFlow בהצלחה.

אימות הגדרת ה-GPU:

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

אם מוחזרת רשימה של התקני GPU, התקנת את TensorFlow בהצלחה. אם לא, המשך לשלב הבא .

6. [GPU בלבד] הגדרת סביבה וירטואלית

אם בדיקת ה-GPU בסעיף הקודם לא הצליחה, הסיבה הסבירה ביותר היא שהרכיבים לא מזוהים, ו/או מתנגשים עם התקנת CUDA הקיימת של המערכת. לכן עליך להוסיף קישורים סמליים כדי לתקן זאת.

  • צור קישורים סמליים לספריות משותפות של NVIDIA:
pushd $(dirname $(python -c 'print(__import__("tensorflow").__file__)'))
ln -svf ../nvidia/*/lib/*.so* .
popd
  • צור קישור סמלי ל-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

אימות הגדרת ה-GPU:

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

מק OS

1. דרישות מערכת

  • macOS 10.12.6 (Sierra) ומעלה (64 סיביות)

נכון לעכשיו, אין תמיכה רשמית של GPU להפעלת TensorFlow ב-MacOS. ההוראות הבאות מיועדות להפעלת TensorFlow על גבי מעבד.

2. בדוק את גרסת הפייתון

בדוק אם סביבת הפייתון שלך כבר מוגדרת:

python3 --version
python3 -m pip --version

3. התקנת TensorFlow

TensorFlow דורש גרסה עדכנית של pip, לכן שדרגו את התקנת ה-pip שלכם כדי לוודא שאתם מפעילים את הגרסה העדכנית ביותר.

pip install --upgrade pip

לאחר מכן, התקן את TensorFlow באמצעות pip.

pip install tensorflow

4. אימות ההתקנה

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

אם מוחזר טנזור, התקנת את TensorFlow בהצלחה.

Windows מקורי

1. דרישות מערכת

  • Windows 7 ומעלה (64 סיביות)

2. התקנת Microsoft Visual C++ Redistributable

התקן את Microsoft Visual C++ Redistributable עבור Visual Studio 2015, 2017 ו-2019 . החל מגרסת TensorFlow 2.1.0, קובץ msvcp140_1.dll נדרש מחבילה זו (שייתכן שלא מסופקת בחבילות ישנות יותר של הפצה חוזרת). קובץ ההפצה חוזרת מגיע עם Visual Studio 2019 אך ניתן להתקין אותו בנפרד:

  1. עבור אל הורדות של Microsoft Visual C++ .
  2. גלול מטה בדף אל הקטע Visual Studio 2015, 2017 ו-2019 .
  3. הורד והתקן את Microsoft Visual C++ Redistributable עבור Visual Studio 2015, 2017 ו-2019 עבור הפלטפורמה שלך.

ודא ש"נתיבים ארוכים" מופעלים ב-Windows.

3. התקנת מיניקונדה

מיניקונדה היא הגישה המומלצת להתקנת TensorFlow עם תמיכה ב-GPU. היא יוצרת סביבה נפרדת כדי למנוע שינוי של תוכנות המותקנות במערכת. זוהי גם הדרך הקלה ביותר להתקין את התוכנה הנדרשת, במיוחד עבור הגדרת ה-GPU.

הורד את מתקין Windows של Miniconda . לחץ פעמיים על הקובץ שהורדת ופעל לפי ההוראות שעל המסך.

4. צור סביבת קונדום

צור סביבת conda חדשה בשם tf באמצעות הפקודה הבאה.

conda create --name tf python=3.9

ניתן לבטל ולהפעיל אותו באמצעות הפקודות הבאות.

conda deactivate
conda activate tf

ודא שהוא מופעל למשך שאר ההתקנה.

5. הגדרת כרטיס מסך

ניתן לדלג על סעיף זה אם אתם מפעילים את TensorFlow רק על המעבד.

תחילה התקן את מנהל ההתקן של כרטיס המסך של NVIDIA אם עדיין לא עשית זאת.

לאחר מכן התקן את CUDA, cuDNN עם conda.

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

6. התקנת TensorFlow

TensorFlow דורש גרסה עדכנית של pip, לכן שדרגו את התקנת ה-pip שלכם כדי לוודא שאתם מפעילים את הגרסה העדכנית ביותר.

pip install --upgrade pip

לאחר מכן, התקן את TensorFlow באמצעות pip.

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

7. אימות ההתקנה

בדוק את הגדרת המעבד:

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

אם מוחזר טנזור, התקנת את TensorFlow בהצלחה.

אימות הגדרת ה-GPU:

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

אם מוחזרת רשימה של התקני GPU, התקנת את TensorFlow בהצלחה.

Windows WSL2

1. דרישות מערכת

  • Windows 10 19044 ומעלה (64 סיביות). גרסה זו מתאימה ל-Windows 10 גרסה 21H2, עדכון נובמבר 2021.

עיין במסמכים הבאים:

2. הגדרת כרטיס מסך

ניתן לדלג על סעיף זה אם אתם מפעילים את TensorFlow רק על המעבד.

התקן את מנהל ההתקן של כרטיס המסך של NVIDIA אם עדיין לא עשית זאת. באפשרותך להשתמש בפקודה הבאה כדי לוודא שהוא מותקן.

nvidia-smi

3. התקנת TensorFlow

TensorFlow דורש גרסה עדכנית של pip, לכן שדרגו את התקנת ה-pip שלכם כדי לוודא שאתם מפעילים את הגרסה העדכנית ביותר.

pip install --upgrade pip

לאחר מכן, התקן את TensorFlow באמצעות pip.

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

4. אימות ההתקנה

בדוק את הגדרת המעבד:

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

אם מוחזר טנזור, התקנת את TensorFlow בהצלחה.

אימות הגדרת ה-GPU:

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

אם מוחזרת רשימה של התקני GPU, התקנת את TensorFlow בהצלחה.

מיקום החבילה

מספר מנגנוני התקנה דורשים את כתובת ה-URL של חבילת TensorFlow Python. הערך שתציין תלוי בגרסת Python שלך.

תמיכה בגרסת Python

גִרְסָה כתובת אתר
לינוקס x86
תמיכה ב-GPU של 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 מעבד בלבד https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp310-cp310-manylinux_2_27_x86_64.whl
תמיכה ב-GPU של 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 מעבד בלבד https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp311-cp311-manylinux_2_27_x86_64.whl
תמיכה ב-GPU של 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 מעבד בלבד 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
תמיכה ב-GPU של 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 מעבד בלבד https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow_cpu-2.21.0-cp313-cp313-manylinux_2_27_x86_64.whl
לינוקס Arm64 (מעבד בלבד)
פייתון 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-manylinux_2_27_aarch64.whl
פייתון 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-manylinux_2_27_aarch64.whl
פייתון 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-manylinux_2_27_aarch64.whl
פייתון 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 (מעבד בלבד)
זהירות : TensorFlow 2.16 הייתה גרסת TensorFlow האחרונה שתמכה ב-macOS x86.
פייתון 3.10 https://storage.googleapis.com/tensorflow/versions/2.16.2/tensorflow-2.16.2-cp310-cp310-macosx_10_15_x86_64.whl
פייתון 3.11 https://storage.googleapis.com/tensorflow/versions/2.16.2/tensorflow-2.16.2-cp311-cp311-macosx_10_15_x86_64.whl
פייתון 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 (מעבד בלבד)
פייתון 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-macosx_12_0_arm64.whl
פייתון 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-macosx_12_0_arm64.whl
פייתון 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-macosx_12_0_arm64.whl
פייתון 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-macosx_12_0_arm64.whl
Windows (מעבד בלבד)
פייתון 3.10 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp310-cp310-win_amd64.whl
פייתון 3.11 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp311-cp311-win_amd64.whl
פייתון 3.12 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp312-cp312-win_amd64.whl
פייתון 3.13 https://storage.googleapis.com/tensorflow/versions/%222.21.0%22/tensorflow-2.21.0-cp313-cp313-win_amd64.whl