Python에 XGBoost 설치

XGBoost는 그래디언트 부스팅 결정 트리를 위한 오픈 소스 라이브러리입니다. Python에서 사용하려면 프로젝트를 실행할 환경에 pip 또는 conda로 설치하세요. 빌드를 사용자 지정하거나 패키지로 제공되는 릴리스가 지원하지 않는 설정을 사용해야 하는 경우에는 소스에서 빌드할 수 있으며, 이는 고급 사용자용 방법입니다.

설치 방법 선택하기

프로젝트에서 이미 pip와 일반적인 Python 환경을 사용하고 있다면 pip를 선택하세요. conda로 프로젝트를 관리하고 환경 및 패키지 도구를 함께 사용해 종속성을 관리하려면 conda를 선택하세요. 환경에서 패키지를 어떻게 해결하는지 잘 모른다면 한 환경에서 여러 패키지 관리자를 혼용하지 마세요.

먼저 사용할 환경을 선택하거나 활성화한 다음 해당 환경의 패키지 관리자를 실행하세요. 아래 패키지 명령은 이 문서 초안 작성 과정에서 실행되지 않았습니다. 설치하기 전에 공식 XGBoost 설치 안내와 릴리스 문서에서 최신 패키지 설치 방법과 지원되는 Python 및 플랫폼 조합을 확인하세요.

pip로 XGBoost 설치하기

사용하려는 Python 환경의 터미널에서 python -m pip install xgboost를 실행하세요. python -m pip를 사용하면 pip가 해당 인터프리터와 연결되므로 다른 Python 설치에 패키지를 설치하는 일을 방지하는 데 도움이 됩니다. 시스템에서 명령 이름이 python3인 경우에는 python3 -m pip install xgboost를 사용하세요.

기존 pip 설치를 업데이트하려면 같은 환경에서 python -m pip install --upgrade xgboost를 실행하세요. pip가 표시하는 종속성 또는 호환성 관련 메시지를 확인하고, 아래 설치 확인 단계로 설치 상태를 점검하세요.

conda로 XGBoost 설치하기

프로젝트의 conda 환경을 활성화한 다음 공식 XGBoost 설치 안내에 있는 conda-forge 명령을 따르세요. 현재 안내된 명령은 conda install -c conda-forge py-xgboost입니다. 이 명령은 conda-forge 채널과 Python 패키지를 선택합니다. 패키지 이용 가능 여부는 플랫폼과 릴리스에 따라 다를 수 있으므로 설치하거나 업데이트하기 전에 안내를 확인하세요. 사용 중인 환경에 대해 안내에 명시된 패키지 이름과 채널을 사용하세요.

소스에서 XGBoost 빌드하기

XGBoost를 사용자 지정해야 하거나 사용 가능한 패키지가 플랫폼 및 요구 사항을 지원하지 않는 경우에는 소스에서 빌드할 수 있습니다. 이 방법은 고급 사용자에게 적합합니다. 운영 체제와 릴리스에 필요한 사전 조건 및 명령은 공식 XGBoost 소스 빌드 안내를 따르세요. 이 안내에는 기본 빌드 과정과 Python 패키지 설치 방법이 포함되어 있습니다. 빌드 요구 사항과 명령은 변경될 수 있으므로 일반적인 절차를 따르기보다 최신 안내에 나온 단계를 사용하세요. 빌드한 Python 패키지는 프로젝트에서 사용하는 것과 같은 환경에 설치하세요.

설치 확인 및 일반적인 문제 해결

프로젝트에서 선택한 Python 인터프리터로 다음 자체 포함 확인 코드를 실행하세요. 설치된 XGBoost 버전을 표시하거나, 해당 인터프리터에서 패키지를 찾을 수 없을 때 알아보기 쉬운 메시지를 출력합니다. 예시의 출력 메시지는 변경되지 않은 영어 문구로 표시됩니다.

import importlib.util

if importlib.util.find_spec("xgboost") is None:
    print("XGBoost is not installed in this Python environment.")
else:
    import xgboost

    print(f"XGBoost {xgboost.__version__}")

XGBoost is not installed in this Python environment.

설치했는데도 확인 결과 XGBoost가 설치되지 않은 것으로 나온다면, 설치에 사용한 인터프리터와 애플리케이션을 실행하는 인터프리터를 비교하세요. pip를 사용한다면 python -m pip show xgboost로 해당 인터프리터에 연결된 패키지를 확인할 수 있습니다. conda를 사용한다면 conda list xgboost로 활성화된 환경의 패키지를 확인하세요. 설치와 확인은 동일한 활성 환경에서 진행하세요. 환경이 일치한다면 전체 가져오기 오류 메시지를 확인하고, 종속성을 변경하기 전에 운영 체제, Python 버전 및 XGBoost 릴리스에 맞는 공식 설치 안내를 살펴보세요.

자주 묻는 질문

가상 환경에 XGBoost를 설치할 수 있나요?

네. 먼저 venv 또는 conda 환경을 활성화하고, 해당 환경의 패키지 관리자로 XGBoost를 설치한 다음 그 환경의 Python 인터프리터로 확인 코드를 실행하세요.

어떤 Python 버전과 플랫폼이 지원되나요?

지원 여부는 XGBoost 릴리스와 이용 가능한 패키지 빌드에 따라 달라집니다. 설치하려는 릴리스에서 지원하는 Python 버전과 플랫폼은 공식 릴리스 및 설치 문서에서 확인하세요.

XGBoost를 다른 머신러닝 라이브러리와 함께 사용할 수 있나요?

XGBoost는 Python 패키지를 제공하며 다른 라이브러리와 함께 Python 프로젝트에서 사용할 수 있습니다. 특정 라이브러리와 통합하려면 해당 라이브러리의 최신 문서를 따르고 설치된 버전 간 호환성을 확인하세요.