압축만 풀면 바로 실행되는 파이썬, python-build-standalone 이야기

'파이썬 설치'가 왜 아직도 어려운 걸까요

파이썬 개발하면서 제일 허무하게 시간을 잃는 순간이 언제냐고 물으면, 저는 '파이썬 자체를 설치할 때'라고 답하고 싶어요. 코드는 한 줄도 안 짰는데 pyenv로 빌드하다가 openssl 에러가 나고, 회사 리눅스 서버에는 낡은 파이썬이 박혀 있고, 새 맥북에서는 또 다른 버전이 잡히고... 다들 한 번쯤 겪어보셨을 거예요.

이게 왜 어렵냐면, 파이썬 인터프리터(파이썬 코드를 읽어서 실행해주는 프로그램, 즉 python 실행 파일 그 자체)가 시스템에 꽤 깊게 엮여 있기 때문이에요. CPython을 소스에서 빌드하면 그 컴퓨터에 깔린 openssl, libffi, zlib 같은 시스템 라이브러리에 동적으로 연결되거든요. 그래서 A 서버에서 빌드한 파이썬을 B 서버로 복사하면 '라이브러리를 찾을 수 없음' 에러와 함께 죽어버리는 일이 흔했어요.

python-build-standalone이 하는 일

오늘 소개할 python-build-standalone은 이 문제를 정면으로 해결하는 프로젝트예요. PyOxidizer를 만든 Gregory Szorc가 시작했고, 지금은 uv와 ruff를 만드는 Astral이 이어받아 관리하고 있는데요. 한 문장으로 요약하면 '압축을 풀면 그 자리에서 바로 실행되고, 어느 컴퓨터로 옮겨도 잘 도는 CPython 배포판을 미리 빌드해서 제공하는 프로젝트'예요.

비결은 빌드 과정을 극단적으로 통제하는 데 있어요. 의존 라이브러리를 시스템에서 가져오는 대신 가능한 한 전부 직접 빌드해서 정적으로(실행 파일 안에 포함시키는 방식으로) 묶어버리고, 리눅스에서는 일부러 오래된 glibc 버전을 기준으로 빌드해서 낡은 배포판에서도 돌아가게 만들어요. 결과물은 리눅스(glibc/musl), macOS(인텔/애플 실리콘), 윈도우까지 주요 플랫폼별 아카이브로 나오고요. 다운로드해서 압축 풀고 bin/python3를 실행하면 끝이에요. sudo도, 컴파일도, 시스템 오염도 없어요.

사실 여러분은 이미 쓰고 있을지도 몰라요

이 프로젝트가 재밌는 건, 이름은 처음 들어도 이미 쓰고 있는 분이 많다는 거예요. uv python install 3.13 이라고 치면 몇 초 만에 파이썬이 설치되죠? 그때 내려받는 게 바로 이 프로젝트의 빌드예요. pyenv가 매번 소스를 컴파일하느라 몇 분씩 걸리는 것과 비교하면 차이가 확 나거든요. Rye 같은 도구들과 여러 CI 환경도 이 빌드를 가져다 써요. 어느새 파이썬 생태계의 숨은 기반 시설이 된 셈이에요.

물론 공식 python.org 빌드와 100% 똑같지는 않아요. 정적 링크 때문에 생기는 미묘한 차이들이 있어서, 공식 문서에 '동작 차이(quirks)' 목록이 따로 정리돼 있을 정도거든요. 예를 들어 터미널 입력 처리에 readline 대신 libedit이 들어가는 경우가 있다든지, 특수한 C 확장 모듈을 다룰 때 신경 쓸 점이 있다든지 하는 것들이요. 대부분의 웹 개발이나 데이터 작업에서는 체감할 일이 거의 없지만, 네이티브 모듈을 깊게 쓰는 프로젝트라면 그 문서를 한번 훑어보는 게 좋아요.

다른 선택지들과 비교하면

같은 문제를 푸는 기존 도구들을 떠올려보면 각자 아쉬운 구석이 있었어요. pyenv는 소스 빌드라 느리고 빌드 의존성을 먼저 깔아야 하고, conda는 자체 생태계가 커서 무겁고, 도커 이미지는 컨테이너 밖에서는 쓸 수 없고, OS 패키지 매니저는 버전 선택지가 좁죠. python-build-standalone은 '미리 빌드된 이식 가능한 인터프리터'라는 딱 한 가지에 집중해서 이 도구들 사이의 빈틈을 메워요. 특히 CI에서 파이썬 준비 시간이 몇 분에서 몇 초로 줄어드는 건 매일 쌓이면 꽤 큰 이득이거든요. 이런 수요가 확인되면서 CPython 쪽에서도 공식 바이너리 배포를 개선하려는 논의가 이어지고 있기도 해요.

이렇게 활용해보세요

한국 개발자 입장에서 당장 써먹을 곳은 세 가지 정도예요. 첫째, 팀 개발 환경 통일이요. uv와 함께 쓰면 '파이썬 버전부터 맞추자'는 온보딩 고통이 사라져요. 둘째, CI/CD 파이프라인 속도 개선이요. 캐시 전략을 고민하기 전에 인터프리터 설치 자체가 빨라지니까요. 셋째, 파이썬을 내장한 제품 배포예요. 사내 도구나 데스크톱 앱에 파이썬을 통째로 껴서 나눠주고 싶을 때, 사용자에게 '파이썬 먼저 설치하세요'라고 안 해도 되거든요.

정리하면, python-build-standalone은 '파이썬 설치'라는 해묵은 골칫거리를 미리 빌드된 이식형 배포판이라는 방식으로 풀어낸 프로젝트고, uv 덕분에 이미 우리 일상에 조용히 스며들어 있어요. 여러분 팀은 파이썬 버전 관리를 어떻게 하고 계세요? pyenv에서 uv로 넘어가신 분들은 체감 차이가 얼마나 나는지 궁금하네요.