구글 Gemma Python 라이브러리 설치 시, OSError 오류 해결법

구글에서 배포한 Gemma4 경량 모델을 파인튜닝하기 위해
로컬에 환경 구축을 하다가 생긴 에러를 해결하였습니다.

배경

구글에서 배포한 gemma 라이브러리는
gemma 모델을 활용할 뿐 아니라 튜닝하고, 테스트하고, 체크포인팅하는 등
연구용으로 적합하게 사용할 수 있도록 다양한 라이브러리를 포함하고 있다.

gemma가 포함하고 있는 오픈소스 라이브러리 중
orbax은 모델 체크포인팅,

optax는 Gradient 작업과 관련된 연산,
kauldron은 머신러닝 모델을 학습시키기 위한 라이브러리다.



JAX라는 파이썬 고성능 수치계산 라이브러리를 알아둘 필요가 있다.
gemma가 포함하고 있는 라이브러리들이
JAX에 기반하고 있기 때문이다.
경쟁 라이브러리에는 PyTorch, Tensorflow가 있다. 

 

orbax는 orbax-checkpoint, orbax-export 라는
orbax 네임스페이스를 가진 다른 라이브러리로 이뤄져있다.

본론

Python 버전 3.11 이상 이어야 하기 때문에 

Python 3.13의 가상환경에 설치하는데 다음과 같은 에러가 발생했다.

[orbax-checkpoint]ERROR: Could not install packages due to an OSError:
[Errno 2] No such file or directory: 'e:\\Users\\...\gemma\\.venv\\Lib\\site-packages\\orbax\\checkpoint\\experimental\\v1\\_src\\testing\\compatibility\\checkpoints\\v0_checkpoints\\composite_checkpoint\\checkpoint_metadata_missing\\pytree_checkpointable_has_metadata\\state\\d\\ea2cd2503f2fab2439cfe73cda290980'

HINT: This error might have occurred since this system does not have Windows Long Path support enabled. You can find information on how to enable this at https://pip.pypa.io/warnings/enable-long-paths

윈도우 시스템에서 Windows Long Path 기능이 꺼져 있는 것이 원인이다.
처음 Python 윈도우 버전을 설치할 때,
Long Path 활성화 옵션을 건너 뛴 것이 원인인 듯. 

아래 링크를 참고해서 다시 활성해주자.

https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later

명령어 한 줄로 해결할 수 있는
Powsershell을 사용했고 성공했다면 아래와 같이 뜰 것이다.
( 이 때, Powershell을 관리자 권한으로 열어줘야한다. )

다시 gemma를 설치 해주면 정상적으로 설치된다.