בנה ממקור ב-Windows

בנה חבילת pip של TensorFlow מהמקור והתקן אותה על Windows.

התקנה עבור Windows

התקן את כלי הבנייה הבאים כדי להגדיר את סביבת הפיתוח של Windows שלך.

התקנת Python ותלויות חבילת TensorFlow

התקן גרסת Python 3.9+‎ של 64 סיביות עבור Windows . בחר pip כתכונה אופציונלית והוסף אותה למשתנה הסביבתי %PATH% .

התקן את תלויות חבילת TensorFlow pip :

pip3 install -U pip
pip3 install -U six numpy wheel packaging
pip3 install -U keras_preprocessing --no-deps

התלויות רשומות בקובץ setup.py תחת REQUIRED_PACKAGES .

התקנת באזל

התקן את Bazel , כלי הבנייה המשמש לקימפול TensorFlow. עבור גרסת Bazel, עיין בתצורות הבנייה שנבדקו עבור Windows. קבע את התצורה של Bazel לבניית C++ .

הוסף את מיקום קובץ ההפעלה של Bazel למשתנה הסביבה %PATH% שלך.

התקנת MSYS2

התקן את MSYS2 עבור כלי ה-bin הדרושים לבניית TensorFlow. אם MSYS2 מותקן ב- C:\msys64 , הוסף C:\msys64\usr\bin למשתנה הסביבה %PATH% . לאחר מכן, באמצעות cmd.exe , הפעל:

pacman -Syu (requires a console restart)
pacman -S git patch unzip
pacman -S git patch unzip rsync

התקנת כלי בנייה של Visual C++ 2022

התקן את כלי הבנייה של Visual C++ 2022. כלי זה מגיע עם Visual Studio Community 2022 אך ניתן להתקין אותו בנפרד:

1. עבור אל הורדות Visual Studio ,
2. בחר כלים עבור Visual Studio או כלים אחרים, Framework ו-Redistributables ,
3. הורדה והתקנה:
   • בניית כלים עבור Visual Studio 2022
   • קבצי הפצה חוזרים של Microsoft Visual C++ עבור Visual Studio 2022

התקנת LLVM

1. עבור אל הורדות LLVM ,
2. הורד והתקן LLVM תואם Windows בקובץ C:/Program Files/LLVM, לדוגמה, LLVM-17.0.6-win64.exe

התקנת תמיכה ב-GPU (אופציונלי)

עיין במדריך התמיכה של GPU של Windows כדי להתקין את מנהלי ההתקנים והתוכנות הנוספות הנדרשות להפעלת TensorFlow על GPU.

הורד את קוד המקור של TensorFlow

השתמש ב-Git כדי לשכפל את מאגר TensorFlow ( git מותקן עם MSYS2):

git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow

ברירת המחדל של המאגר היא ענף פיתוח master . ניתן גם לבדוק ענף שחרור כדי לבנות:

git checkout branch_name  # r1.9, r1.10, etc.

אופציונלי: הגדרת משתנה סביבתי

הפעל את הפקודות הבאות לפני הפעלת פקודת הבנייה כדי למנוע בעיות ביצירת חבילות: (אם הפקודות שלהלן הוגדרו בעת התקנת החבילות, אנא התעלם מהן). הפעל את הפקודה set כדי לבדוק אם כל הנתיבים הוגדרו כהלכה, הפעל את הפקודה echo %Environmental Variable% לדוגמה, echo %BAZEL_VC% כדי לבדוק את הנתיב שהוגדר עבור משתנה סביבתי ספציפי.

בעיית הגדרת נתיב בפייתון tensorflow:issue#59943 , tensorflow:issue#9436 , tensorflow:issue#60083

set PATH=path/to/python;%PATH% # [e.g. (C:/Python311)]
set PATH=path/to/python/Scripts;%PATH% # [e.g. (C:/Python311/Scripts)] 
set PYTHON_BIN_PATH=path/to/python_virtualenv/Scripts/python.exe 
set PYTHON_LIB_PATH=path/to/python virtualenv/lib/site-packages 
set PYTHON_DIRECTORY=path/to/python_virtualenv/Scripts 

בעיית הגדרת נתיב Bazel/MSVC/CLANG tensorflow:בעיה#54578

set BAZEL_SH=C:/msys64/usr/bin/bash.exe 
set BAZEL_VS=C:/Program Files/Microsoft Visual Studio/2022/BuildTools 
set BAZEL_VC=C:/Program Files/Microsoft Visual Studio/2022/BuildTools/VC 
set Bazel_LLVM=C:/Program Files/LLVM (explicitly tell Bazel where LLVM is installed by BAZEL_LLVM, needed while using CLANG)
set PATH=C:/Program Files/LLVM/bin;%PATH% (Optional, needed while using CLANG as Compiler)

אופציונלי: הגדרת הבנייה

קבצי TensorFlow מוגדרים על ידי קובץ ה-. .bazelrc בספריית השורש של המאגר. ניתן להשתמש בסקריפטים ./configure או ./configure.py כדי להתאים הגדרות נפוצות.

אם עליך לשנות את התצורה, הפעל את הסקריפט ./configure מספריית השורש של המאגר.

python ./configure.py

סקריפט זה מבקש ממך את מיקום תלויות TensorFlow ומבקש אפשרויות תצורה נוספות של בנייה (דגלי מהדר, לדוגמה). להלן דוגמה להרצה של python ./configure.py (ההפעלה שלך עשויה להיות שונה):

python ./configure.py
You have bazel 6.5.0 installed.
Please specify the location of python. [Default is C:\Python311\python.exe]:

Found possible Python library paths:
C:\Python311\lib\site-packages
Please input the desired Python library path to use.  Default is [C:\Python311\lib\site-packages]

Do you wish to build TensorFlow with ROCm support? [y/N]:
No ROCm support will be enabled for TensorFlow.

Warning: Cannot build with CUDA support on Windows.
Starting in TF 2.11, CUDA build is not supported for Windows. To use TensorFlow GPU on Windows, you will need to build/install TensorFlow in WSL2.

Do you want to use Clang to build TensorFlow? [Y/n]:
Add "--config=win_clang" to compile TensorFlow with CLANG.

Please specify the path to clang executable. [Default is C:\Program Files\LLVM\bin\clang.EXE]:

You have Clang 17.0.6 installed.

Please specify optimization flags to use during compilation when bazel option "--config=opt" is specified [Default is /arch:AVX]:

Would you like to override eigen strong inline for some C++ compilation to reduce the compilation time? [Y/n]:
Eigen strong inline overridden.

Would you like to interactively configure ./WORKSPACE for Android builds? [y/N]:
Not configuring the WORKSPACE for Android builds.

Preconfigured Bazel build configs. You can use any of the below by adding "--config=<>" to your build command. See .bazelrc for more details.
        --config=mkl            # Build with MKL support.
        --config=mkl_aarch64    # Build with oneDNN and Compute Library for the Arm Architecture (ACL).
        --config=monolithic     # Config for mostly static monolithic build.
        --config=numa           # Build with NUMA support.
        --config=dynamic_kernels        # (Experimental) Build kernels into separate shared objects.
        --config=v1             # Build with TensorFlow 1 API instead of TF 2 API.
Preconfigured Bazel build configs to DISABLE default on features:
        --config=nogcp          # Disable GCP support.
        --config=nonccl         # Disable NVIDIA NCCL support.

בנה והתקן את חבילת pip

חבילת pip נבנית בשני שלבים. פקודת bazel build יוצרת תוכנית "package-builder". לאחר מכן מפעילים את package-builder כדי ליצור את החבילה.

בנה את בונה החבילות

מאגר tensorflow:master עודכן לגרסה 2.x כברירת מחדל. התקן את Bazel והשתמש bazel build כדי ליצור את בונה החבילות של TensorFlow.

bazel build //tensorflow/tools/pip_package:wheel

מעבד בלבד

השתמש bazel כדי ליצור את בונה החבילות TensorFlow עם תמיכה במעבד בלבד:

בנה עם MSVC

bazel build --config=opt --repo_env=TF_PYTHON_VERSION=3.11 //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

בנה עם CLANG

השתמש ב--config= win_clang כדי לבנות TenorFlow עם המהדר של CLANG:

bazel build --config=win_clang --repo_env=TF_PYTHON_VERSION=3.11 //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

תמיכה ב-GPU

כדי ליצור את בונה החבילות TensorFlow עם תמיכה ב-GPU:

bazel build --config=opt --config=cuda --define=no_tensorflow_py_deps=true //tensorflow/tools/pip_package:build_pip_package

פקודות לניקוי המטמון של Bazel כדי לפתור שגיאות עקב נתונים לא חוקיים או לא מעודכנים במטמון, Bazel clean עם הדגל --expunge מסיר קבצים לצמיתות.

bazel clean 
bazel clean --expunge  

אפשרויות בנייה של באזל

השתמש באפשרות זו בעת בנייה כדי להימנע מבעיות ביצירת חבילות: tensorflow:issue#22390

--define=no_tensorflow_py_deps=true

עיין בהפניה לשורת הפקודה של Bazel עבור אפשרויות בנייה .

בניית TensorFlow ממקור המערכת יכולה להשתמש בהרבה זיכרון RAM. אם המערכת שלך מוגבלת בזיכרון, הגבל את השימוש ב-RAM של Bazel באמצעות: --local_ram_resources=2048 .

אם בונים עם תמיכה ב-GPU, הוסיפו --copt=-nvcc_options=disable-warnings כדי לדכא הודעות אזהרה של nvcc.

בנה את החבילה

כדי לבנות חבילת pip, עליך לציין את הדגל --repo_env=WHEEL_NAME. בהתאם לשם שסופק, החבילה תיווצר. לדוגמה:

כדי לבנות חבילת CPU של tensorflow:

bazel build //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

כדי לבנות חבילת nightly, יש להגדיר tf_nightly במקום tensorflow , לדוגמה כדי לבנות חבילת nightly של המעבד:

bazel build //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tf_nightly_cpu

כתוצאה מכך, הגלגל שנוצר ימוקם ב

bazel-bin/tensorflow/tools/pip_package/wheel_house/

התקן את החבילה

שם הקובץ של קובץ ה- .whl שנוצר תלוי בגרסת TensorFlow ובפלטפורמה שלך. השתמש pip install כדי להתקין את החבילה, לדוגמה:

pip install bazel-bin/tensorflow/tools/pip_package/wheel_house/tensorflow-version-tags.whl

בנה באמצעות מעטפת MSYS

ניתן לבנות את TensorFlow גם באמצעות מעטפת MSYS. בצעו את השינויים המפורטים להלן, ולאחר מכן עקבו אחר ההוראות הקודמות עבור שורת הפקודה המקורית של Windows ( cmd.exe ).

השבתת המרת נתיב MSYS

MSYS ממיר אוטומטית ארגומנטים שנראים כמו נתיבי יוניקס לנתיבי חלונות, וזה לא עובד עם bazel . (התווית //path/to:bin נחשבת לנתיב מוחלט של יוניקס מכיוון שהיא מתחילה בקו נטוי.)

export MSYS_NO_PATHCONV=1
export MSYS2_ARG_CONV_EXCL="*"

הגדר את הנתיב שלך

הוסף את ספריות ההתקנה של Bazel ו-Python למשתנה הסביבתי $PATH שלך. אם Bazel מותקן ב- C:\tools\bazel.exe , ו-Python ב- C:\Python\python.exe , הגדר PATH שלך עם:

# Use Unix-style with ':' as separator
export PATH="/c/tools:$PATH"
export PATH="/c/path/to/Python:$PATH"

לתמיכה ב-GPU, הוסף את ספריות ה-bin של CUDA ו-cuDNN ל- $PATH שלך:

export PATH="/c/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.0/bin:$PATH"
export PATH="/c/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.0/extras/CUPTI/libx64:$PATH"
export PATH="/c/tools/cuda/bin:$PATH"

תצורות בנייה שנבדקו

מעבד

כרטיס מסך