Repolode
pyinstaller

pyinstaller/pyinstaller

Python 프로그램을 독립 실행 파일로 패키징해 Python 인터프리터 없이 실행할 수 있습니다.

대체할 수 있는 제품:py2exe

스타
13,141
포크
2,036
열린 이슈
117
마지막 커밋
4일 전

어떤 프로젝트인가요?

PyInstaller는 Python 애플리케이션과 그 종속성, Python 인터프리터를 함께 묶어 하나의 폴더나 실행 파일 하나로 만듭니다. 패키징된 앱은 Python이나 모듈을 설치하지 않아도 실행할 수 있습니다. 스크립트를 분석해 가져오는 모든 모듈과 라이브러리를 찾은 다음, 해당 파일들을 인터프리터와 함께 모으는 방식으로 작동합니다.

Windows, macOS, GNU/Linux에서 테스트되었으며 Python 3.8~3.15를 지원합니다. pip로 설치한 뒤 메인 스크립트에 실행하면 됩니다. PyInstaller는 크로스 컴파일러가 아니므로 특정 운영체제용 앱은 해당 운영체제에서 빌드해야 합니다. numpy, PyQt5/6, PySide2/6, wxPython, matplotlib 같은 주요 패키지를 기본 지원합니다.

macOS에서는 코드 서명을 지원하고 universal2 애플리케이션을 빌드할 수 있으며, Windows에서는 MS Visual C++ DLL을 함께 포함합니다.

핵심 기능

  • 01스크립트와 종속성을 하나의 폴더나 실행 파일 하나로 패키징합니다.
  • 02Python 인터프리터를 함께 묶어 대상 컴퓨터에 Python을 설치할 필요가 없습니다.
  • 03PyQt, PySide, wxPython, numpy, matplotlib 같은 주요 GUI 및 과학용 패키지를 지원합니다.
  • 04Windows, macOS, GNU/Linux에서 작동하며, macOS 코드 서명과 universal2 빌드를 지원합니다.
  • 05pip 명령 하나로 설치하고 명령줄에서 실행할 수 있습니다.

활용 사례

  • Python이 설치되지 않은 사용자에게 데스크톱 Python 도구를 배포할 때
  • PyQt 또는 wxPython으로 만든 GUI 애플리케이션을 설치 프로그램에 바로 포함할 수 있는 실행 파일 하나로 제공할 때
  • Python 환경을 따로 관리하지 않고 Windows를 사용하는 동료에게 명령줄 유틸리티를 전달할 때

빠른 시작

  1. 1

    pip으로 PyInstaller를 설치합니다

    pip install pyinstaller
  2. 2

    메인 스크립트에 PyInstaller를 실행합니다

    pyinstaller /path/to/yourscript.py

사용 전 알아둘 점

  • PyInstaller는 크로스 컴파일러가 아니므로 대상과 동일한 운영체제에서 빌드해야 합니다.
  • Python 3.10.0 및 Python 3.16 베타 릴리스는 지원되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

pyinstaller은(는) 무엇인가요?
Python 프로그램을 독립 실행 파일로 패키징해 Python 인터프리터 없이 실행할 수 있습니다. PyInstaller는 Python 애플리케이션과 그 종속성, Python 인터프리터를 함께 묶어 하나의 폴더나 실행 파일 하나로 만듭니다. 패키징된 앱은 Python이나 모듈을 설치하지 않아도 실행할 수 있습니다. 스크립트를 분석해 가져오는 모든 모듈과 라이브러리를 찾은 다음, 해당 파일들을 인터프리터와 함께 모으는 방식으로 작동합니다.
pyinstaller은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pyinstaller은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
pyinstaller은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pyinstaller의 마지막 커밋은 2026년 11월 1일입니다.
pyinstaller은(는) 어디에 사용할 수 있나요?
Python이 설치되지 않은 사용자에게 데스크톱 Python 도구를 배포할 때 PyQt 또는 wxPython으로 만든 GUI 애플리케이션을 설치 프로그램에 바로 포함할 수 있는 실행 파일 하나로 제공할 때 Python 환경을 따로 관리하지 않고 Windows를 사용하는 동료에게 명령줄 유틸리티를 전달할 때
pyinstaller는 어떻게 설치하나요?
pip으로 PyInstaller를 설치합니다: pip install pyinstaller 메인 스크립트에 PyInstaller를 실행합니다: pyinstaller /path/to/yourscript.py
pyinstaller은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pyinstaller/pyinstaller

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트