pip로 TensorFlow 설치

이 가이드는 TensorFlow의 최신 안정 버전을 기준으로 작성되었습니다. 미리 보기 빌드 (나이틀리 빌드) 를 사용하려면 tf-nightly 라는 pip 패키지를 설치하세요. 이전 TensorFlow 버전의 요구 사항은 다음 표를 참조하십시오. CPU 전용 빌드를 사용하려면 tensorflow-cpu 라는 pip 패키지를 설치하세요.

다음은 설치 명령어의 간략한 버전입니다. 단계별 지침은 아래로 스크롤하세요.

리눅스

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 네이티브

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

윈도우 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])))"

매일 밤

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 지원 장치가 지원됩니다.

  • NVIDIA® GPU 카드는 CUDA® 아키텍처 3.5, 5.0, 6.0, 7.0, 7.5, 8.0 이상을 지원합니다. CUDA® 지원 GPU 카드 목록을 참조하십시오.
  • 지원되지 않는 CUDA® 아키텍처를 사용하는 GPU의 경우, 또는 PTX에서 JIT 컴파일을 피하거나 다른 버전의 NVIDIA® 라이브러리를 사용하려면 소스 코드에서 Linux 빌드 가이드를 참조하십시오.
  • 최신 CUDA® 아키텍처를 제외하고는 패키지에 PTX 코드가 포함되어 있지 않습니다. 따라서 CUDA_FORCE_PTX_JIT=1 로 설정된 경우 이전 GPU에서는 TensorFlow가 로드되지 않습니다. (자세한 내용은 애플리케이션 호환성을 참조하십시오.)

시스템 요구 사항

  • 우분투 16.04 이상 (64비트)
  • macOS 12.0(몬터레이) 이상(64비트) (GPU 미지원)
  • Windows 네이티브 - Windows 7 이상(64비트) (TF 2.10 이후 버전에서는 GPU를 지원하지 않습니다)
  • Windows WSL2 - Windows 10 19044 이상 (64비트)

소프트웨어 요구 사항

다음 NVIDIA® 소프트웨어는 GPU 지원에만 필요합니다.

단계별 지침

리눅스

1. 시스템 요구사항

  • 우분투 16.04 이상 (64비트)

TensorFlow는 공식적으로 Ubuntu만 지원합니다. 하지만 다음 지침은 다른 Linux 배포판에서도 작동할 수 있습니다.

2. GPU 설정

TensorFlow를 CPU에서만 실행하는 경우 이 섹션을 건너뛸 수 있습니다.

NVIDIA GPU 드라이버가 설치되어 있지 않다면 설치하십시오. 다음 명령어를 사용하여 설치 여부를 확인할 수 있습니다.

nvidia-smi

3. venv를 사용하여 가상 환경을 생성합니다.

venv 모듈은 파이썬 표준 라이브러리의 일부이며 가상 환경을 생성하는 공식적으로 권장되는 방법입니다.

원하는 가상 환경 디렉토리로 이동하여 다음 명령어를 사용하여 tf 라는 이름의 새 venv 환경을 생성합니다.

python3 -m venv tf 

다음 명령어를 사용하여 활성화할 수 있습니다.

source tf/bin/activate    

설치 과정이 완료될 때까지 가상 환경이 활성화되어 있는지 확인하십시오.

4. TensorFlow를 설치합니다.

TensorFlow를 사용하려면 최신 버전의 pip가 필요하므로, 최신 버전을 사용하고 있는지 확인하려면 pip 설치를 업그레이드하십시오.

pip install --upgrade pip

다음으로, pip를 사용하여 TensorFlow를 설치하세요.

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

6. 설치를 확인합니다.

CPU 설정을 확인하십시오:

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

MacOS

1. 시스템 요구사항

  • macOS 10.12.6(시에라) 이상(64비트)

현재 macOS에서 TensorFlow를 실행하기 위한 공식적인 GPU 지원은 없습니다. 다음 지침은 CPU에서 실행하는 경우에 대한 것입니다.

2. 파이썬 버전을 확인하세요

파이썬 환경이 이미 구성되어 있는지 확인하세요.

python3 --version
python3 -m pip --version

3. TensorFlow를 설치합니다.

TensorFlow를 사용하려면 최신 버전의 pip가 필요하므로, 최신 버전을 사용하고 있는지 확인하려면 pip 설치를 업그레이드하십시오.

pip install --upgrade pip

다음으로, pip를 사용하여 TensorFlow를 설치하세요.

pip install tensorflow

4. 설치를 확인합니다.

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

텐서가 반환되면 TensorFlow 설치가 성공적으로 완료된 것입니다.

Windows 네이티브

1. 시스템 요구사항

  • 윈도우 7 이상 (64비트)

2. Microsoft Visual C++ 재배포 가능 패키지를 설치합니다.

Visual Studio 2015, 2017 및 2019용 Microsoft Visual C++ 재배포 가능 패키지를 설치하십시오. TensorFlow 2.1.0 버전부터는 이 패키지에 포함된 msvcp140_1.dll 파일이 필요합니다(이전 버전의 재배포 가능 패키지에는 이 파일이 포함되어 있지 않을 수 있습니다). 재배포 가능 패키지는 Visual Studio 2019 에 포함되어 있지만 별도로 설치할 수도 있습니다.

  1. Microsoft Visual C++ 다운로드 페이지로 이동하세요.
  2. 페이지를 아래로 스크롤하여 Visual Studio 2015, 2017 및 2019 섹션을 찾으세요.
  3. 사용 중인 플랫폼에 맞는 Visual Studio 2015, 2017 및 2019용 Microsoft Visual C++ 재배포 가능 패키지를 다운로드하여 설치하십시오.

Windows에서 긴 경로 사용이 활성화되어 있는지 확인하십시오.

3. 미니콘다 설치

Miniconda 는 GPU 지원 기능을 갖춘 TensorFlow 설치에 권장되는 방법입니다. Miniconda는 시스템에 설치된 소프트웨어를 변경하지 않고 별도의 환경을 생성합니다. 특히 GPU 설정을 위한 필수 소프트웨어를 설치하는 가장 쉬운 방법이기도 합니다.

Miniconda Windows 설치 프로그램을 다운로드하십시오. 다운로드한 파일을 두 번 클릭하고 화면의 지시를 따르십시오.

4. conda 환경을 생성합니다.

다음 명령어를 사용하여 tf 라는 이름의 새 conda 환경을 생성하세요.

conda create --name tf python=3.9

다음 명령어를 사용하여 비활성화 및 활성화할 수 있습니다.

conda deactivate
conda activate tf

설치 과정이 완료될 때까지 해당 기능이 활성화되어 있는지 확인하십시오.

5. GPU 설정

TensorFlow를 CPU에서만 실행하는 경우 이 섹션을 건너뛸 수 있습니다.

NVIDIA GPU 드라이버가 설치되어 있지 않다면 먼저 설치하십시오.

다음으로 conda를 사용하여 CUDA와 cuDNN을 설치하십시오.

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

6. TensorFlow를 설치합니다.

TensorFlow를 사용하려면 최신 버전의 pip가 필요하므로, 최신 버전을 사용하고 있는지 확인하려면 pip 설치를 업그레이드하십시오.

pip install --upgrade pip

다음으로, pip를 사용하여 TensorFlow를 설치하세요.

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

7. 설치를 확인합니다.

CPU 설정을 확인하십시오:

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 설치가 성공적으로 완료된 것입니다.

윈도우 WSL2

1. 시스템 요구사항

  • Windows 10 19044 이상(64비트). 이는 Windows 10 버전 21H2, 즉 2021년 11월 업데이트에 해당합니다.

다음 문서를 참조하십시오.

2. GPU 설정

TensorFlow를 CPU에서만 실행하는 경우 이 섹션을 건너뛸 수 있습니다.

NVIDIA GPU 드라이버가 설치되어 있지 않다면 설치하십시오. 다음 명령어를 사용하여 설치 여부를 확인할 수 있습니다.

nvidia-smi

3. TensorFlow를 설치합니다.

TensorFlow를 사용하려면 최신 버전의 pip가 필요하므로, 최신 버전을 사용하고 있는지 확인하려면 pip 설치를 업그레이드하십시오.

pip install --upgrade pip

다음으로, pip를 사용하여 TensorFlow를 설치하세요.

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

4. 설치를 확인합니다.

CPU 설정을 확인하십시오:

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 설치가 성공적으로 완료된 것입니다.

패키지 위치

일부 설치 방식에는 TensorFlow Python 패키지의 URL이 필요합니다. 지정하는 값은 Python 버전에 따라 다릅니다.

파이썬 버전 지원

버전 URL
리눅스 x86
Python 3.10 GPU 지원 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 전용 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 지원 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 전용 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 지원 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 전용 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 지원 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 전용 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 (CPU 전용)
파이썬 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 (CPU 전용)
주의 : TensorFlow 2.16은 macOS x86을 지원하는 마지막 TensorFlow 릴리스입니다.
파이썬 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 (CPU 전용)
파이썬 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
윈도우(CPU 전용)
파이썬 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