PyInstaller 기반의 GUI로 Python 스크립트를 독립 실행형 .exe 파일로 변환합니다.
- 스타
- 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
pip으로 PyInstaller를 설치합니다
pip install pyinstaller - 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 통계는 매일 갱신됩니다.
관련 프로젝트
Python 스크립트를 Python이 지원하는 모든 플랫폼에서 실행할 수 있는 독립 실행형 실행 파일로 만드는 도구입니다.
Go 프로젝트의 바이너리를 빌드하고 패키징해 GitHub, 패키지 관리자, 컨테이너 레지스트리에 배포하는 릴리스 자동화 도구입니다.
Nuitka는 Python으로 작성된 Python 컴파일러로, Python 프로그램을 독립 실행 파일이나 확장 모듈로 변환합니다.
애플리케이션과 의존성을 휴대용 virtualenv처럼 실행할 수 있는 단일 .pex 파일로 패키징하는 Python 도구입니다.
Briefcase는 Python 프로젝트를 Mac, Windows, Linux, iOS, Android 및 웹에서 실행되는 독립형 네이티브 앱으로 패키징합니다.